Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Everything you need to get started on a Node.js website with express and socket.IO

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

Node Boilerplate

node-boilerplate takes html-boilerplate, express, connect and Socket.IO and organizes them into a ready to use website project. Its a fast way to get working on your Node website without having to worry about the setup. It takes care of all the boring parts, like setting up your views, 404 page, 500 page, getting the modules organized, etc...

Node Boilerplate has 4 goals:

  1. To end the repetition involved with starting a new Node website project
  2. To never install anything outside of the project directory (For easier production deployment)
  3. To make it easy to install additional modules within the project directory
  4. To enable easy upgrade or freezing of project dependencies

To start a project:

    git clone git://github.com/robrighter/node-boilerplate.git mynewproject
    cd mynewproject
    ./bin/initproject.sh

This will copy down all of the boilerplate files organize them appropriately and init a fresh new git repository within which you can build your next big thing.

To run the boilerplate template app:

    node server.js

Go to http://0.0.0.0:8081 and click on the send message link to see socket.io in action.

To add additional modules:

You can git clone any other modules into the lib folder. Any modules cloned into the git folder can be required as global modules ie.. require('somemodule').

If you have a different set of default modules that you like to use, the structure is setup such that you can fork the project and replace the modules in the lib directory and the initproject.sh script will initialize projects with your new set of modules.

Deployment

node-boilerplate is setup to be easily deployed on a Joyent Node SmartMachine. This means that:

  1. The version of Node is defined in config.json
  2. The main script to run is server.js
  3. The web server port is pulled from process.env.PORT

Note: Currently the port associated with the Joyent SmartMachine is only automatically detected on the server side and not reflected on the client side. When you deploy, be sure to update the client side javascript to reflect the updated socket.IO url. Feel free to write a patch to correct this problem ;-)

Something went wrong with that request. Please try again.