Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rudolf/webapp-boilerplate

Boilerplate for web applications with a Node, Express, MongoDB backend and Backbone Marionette, Jade, Require.js frontend
https://github.com/rudolf/webapp-boilerplate

Last synced: 3 months ago
JSON representation

Boilerplate for web applications with a Node, Express, MongoDB backend and Backbone Marionette, Jade, Require.js frontend

Awesome Lists containing this project

README

        

# Node / Backbone Web App Boilerplate

## Description
Node/Backbone forms a powerful combination for building single page web applications that scale. Because of these two project's popularity, there are several great boilerplate projects out there, but all for either Node or Backbone seperately. This project aims to integrate these two worlds (Backend and Frontend) making it easy to start building next generation web applications.

The most prominent technologies are:

#### Backend:
- Node.js
- Express.js
- Mongoose.js / MongoDB

#### Frontend:
- Backbone.js
- Marionette.js
- Require.js
- Jade Templates
- Stylus CSS Preprocessor

### Other
- CoffeeScript
- Grunt based development environment

Although it should already provide a solid starting point, this project is still a work in progress (See Todo's below).

## Getting started

1. In an Ubuntu 12.10 terminal, run the following command to install the required dependencies. (Or use your distribution's instructions to install Git, Node v0.8, NPM and MongoDB.)

sudo apt-get install git nodejs npm mongodb-server

2. Get the project source code from GitHub

git clone [email protected]:skaapgif/webapp-boilerplate.git webapp
cd webapp

3. Optionally run these commands to set up the node package manager to install node packages in your home folder (useful if you don't have sudo rights, like at a university lab)

cat npmrc >> ~/.npmrc
cat bashrc >> ~/.bashrc
source ~/.bashrc

4. Finally, install node package dependencies and start the server

npm install
npm install -g grunt-cli
npm start

5. Point your browser to localhost:3000 and start hacking! Any changes to source files will cause grunt to recompile/reload.

## Todo
- Mocha BDD api tests
- Mocha BDD frontend tests using WebDriver
- Introduction to folder layout & files, links to relevant tutorials
- Example stylus css
- MongoDB sessions
- Production hardening (Cluster, error handling, monitoring)
- Heroku Procfile and instructions for super easy heroku deployments