bahn-cli

bahn is a ready-for-road HTML5 application stack combining Bootstrap, AngularJS, H5BP, and Node.js (BAHN).

bahn comes pre-rolled a NoSQL database (NeDB or MongoDB), a HTTP application server (Express), and WebSocket support for dynamic applications (Socket.io).

Apart from bundling all of these together, the philosophy is otherwise agnostic. Use one, use all, use some. But have fun!

Installation

To install the bahn command-line interface type:

npm install bahn -g

You must have Node.js installed before installing. To use a MongoDB database, you must have MongoDB installed or access to a MongoDB server.

After installing the bahn command-line interface, navigate to an empty directory and type:

bahn

This will download and install the latest release of bahn. When it's done, visit http://127.0.0.1:8080/ in a web browser. A seed TODO application that puts the stack through through its paces is included in the default release.

Have a look in the application/ directory to see how the default application works. It is intended that you will modify this application to create your own.

Using the line interface

To install and run a bahn application application server, navigate to a (preferably) empty directory and type:

bahn

If you are behind a corporate proxy, you may have to pass the address of your proxy server in order you can install bahn:

bahn --proxy http://proxy:8080/

By default the application server will run on port 8080. To run it on a port 80, try:

bahn --port 80

To run the application server on port 80 and set it to auto-restart after a crash, try:

bahn --port 80 --forever

To do all of the above and use a MongoDB database (as opposed to the default NeDB database), try:

bahn --port 80 --database "mongodb://admin:[email protected]:27017/bahn" --forever

To install/run a bahn application server in a different directory, on port 80, with auto-restart, try:

bahn --port 80 --forever ~/path/to/directory/

For a full list of options, see:

bahn --help

License

All of the software distributed in this stack is released under the MIT license. Node.js (see license) and MongoDB (see license) are distributed separately under different open source licenses.