The NERD stack provides you with an application skeleton with Node.js, Express, React and database connectivity. It provides user with an opportunity to start quickly developing both large and small scale isomorphic/universal javascript web applications using Flux architecture. The skeleton has in place implementations for:
- A server backend using Node.js and Express
- View layer rendered by Facebook's React framework
- Establish database connectivity and perform standard CRUD operations
- Universal JS application architecture sharing resources on server and client
- Unidirectional data flow using Flux architecture
- Gulp build tasks to run the server with automatic restarts and livereload
- Frontend resource bundling and sourcemaps
- Sourcecode linting to ensure code quality
- Test runner and test coverage reporting with Mocha and Istanbul
- ES6 transpilation using Babel
The purpose of this application skeleton is to empower developers to be able to start developing their Node.js + React easily but still maintaining enough wiggle room to not get constrained into heavy frameworks.
[You can find more information on the app from the wiki] (https://github.com/Xantier/nerd-stack/wiki)
The tools of the trade for this application development stack are node.js, git and your preferred database implementation. You can install node.js for Windows or Mac from https://nodejs.org/download/ For Linux you can follow instructions on https://github.com/joyent/node/wiki/Installation
To install git you can download it from http://git-scm.com/downloads or use your package manager to install it.
The application contains multiple implementations of databases. After you have decided which database to use you need to have it running on your local machine to be able to start developing your next big web application with NERD stack. Installation instructions for different databases:
- PostgreSql
- MySql
- SQLite3
- CouchDB
- MongoDB
- Neo4j
- Redis (Windows not officially supported)
- RethinkDB (Not available on Windows)
package.json contains all the dependencies that are required by the project, including the supported database clients, so it might be a good idea to remove the ones that you are not planning to use.
Install the dependencies by running npm install.
You can select your database implementation by modifying configuration file called config.json in app/config/ folder. In the file replace the db attribute with your chosen implementation. Actual DB settings are listed below under their respective names. Please make sure to setup your system how you have configured your database itself. Good things to change are hostname, database name and user credentials.
Please note that PostgreSql, MySql and SQLite3 are handled by the Bookshelf.js module, therefore in the app/config/config.json you should select bookshelf as your db and depending on your actual database of choice, change bookshelf.db to one of the matching database configurations (under bookshelf).
To setup your database, run gulp migrate. It will execute migrations that are stored in app/data/bookshelf/migrations. In order to create your own migrations take a look at the existing files and Knex.js schema builder API.
To run this application you can install this app with usual commands:
git clone [email protected]:Xantier/nerd-stack.git
cd nerd-stack
npm install
gulp dev
Your application will be accessible at http://localhost:3000
When you are happy with your application and plan to run it without development mode you can invoke the following commands:
gulp build
To build the latest frontend resources and
node /config/server.js
To start the server. It is recommended to use something like supervisor to run the application when uptime is important.