Skip to content

The foundation of a state-of-the-art, production-ready web app built by Bitmatica

License

Notifications You must be signed in to change notification settings

bitmatica/bitmatica-web-app-boilerplate

Repository files navigation

Bitmatica Web App Boilerplate

Over the years, the Bitmatica team has tried many technologies and we've gradually assembled a "best practice" contemporary web app stack that we believe is stable, powerful, and production-ready.

This project provides an example of these chosen technologies wired up and working together.

With a few customizations, this could serve as great initial commit for your next web app.

Technologies

Some of the most important components of the stack include:

Category Role Technology
Logic Language ES6+
Views React
Models Ampersand.js Models
Router Ampersand.js Router
Toolbelt lodash
Styles Language Sass
Framework Bootstrap v4
Tools Dependencies npm
Module Bundler Webpack
Linter ESLint

See package.json for a complete list of dependencies.

Getting Started

First, make sure you have a recent version (v6.2.0+) of Node.js installed. Then:

$ git clone https://github.com/bitmatica/bitmatica-web-app-boilerplate.git
$ cd bitmatica-web-app-boilerplate
$ npm install
$ npm run watch

Browse to http://localhost:8888 to see the project in action!

Usage

Install Dependencies

To install application dependencies:

$ npm install

Development

To start a server at http://localhost:8888 that automatically hot reloads on change:

$ npm run watch

Distribution

To build an minified version of the project into ./build:

$ npm run build

By default the "production" environment is built. To build "staging":

$ NODE_ENV=staging npm run build

Linting

To lint script files with ESLint:

$ npm run lint

More Info

Read the TODO for a list of improvements/additions we are considering.

Read main.scss for a description of how our styles are organized and how we use CSS Modules.

Make sure to check out Bitmatica's Javascript Style Guide for a comprehensive listing of our Javascript style rules and their rationales.

About Bitmatica

Bitmatica is a San Francisco-based software design and development company. We build web and mobile applications for companies around the world Visit bitmatica.com to learn more about us.

License

MIT © Bitmatica

About

The foundation of a state-of-the-art, production-ready web app built by Bitmatica

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published