shorttompkins/benm

Boilerplate web app using Backbone.js, ExpressJS, node.js, MongoDB

B.E.N.M Boilerplate

Backbone.js, ExpressJS & node.js, MongoDB

This boilerplate app features a complete backend using node.js with ExpressJS, a data layer using MongoDB with Mongoose, and a complete front-end application built using Backbone.js (with Marionette and Browserify). The front-end application is a simple Contacts manager. All of the code is fairly basic yet functional.

A detailed blog post covering this entire application can be found here: http://kroltech.com/2013/12/boilerplate-web-app-using-backbone-js-expressjs-node-js-mongodb/

• Backbone.js
• Handlebars
• Browserify
• Jasmine tests
• Basic UI app
• Express / Node.js
• Handlebars
• Mocha test runner
• Chai, Sinon, Proxyquire tests
• MongoDB
• Mongoose
• Bower
• package.json
• Grunt:
• Bower install
• Browserify
• Handlebars (precompiled)
• jsHinting
• LESS
• Minification/Uglification
• Karma client testing/tdd
• Mocha node testing
• Watchers
• Concatenation/Copy
• Concurrent runs (server, karma, mongod, etc)

Requirements

node 0.10+ (and npm), mongodb - visit nodejs.org and mongodb.com to download each.

$ sudo npm install -g grunt-cli
$ npm install
$ grunt init:dev

Grunt init:dev only needs to be run the first time to prepare the vendor.js files.

Running the App:

Start the server in DEV mode, with nodemon watching the app for a relaunch, watchers on scripts and less files for rebuild.

$ grunt server

Note: Windows users, for some reason the grunt shell task will not launch mongod during runtime (so the node server will crash). Be sure to launch mongod in another window before starting grunt server.

Front-end Tests/TDD:

Requires PhantomJS to be installed globally:

$ sudo npm install -g phantomjs

To run tests in TDD watch mode:

$ grunt tdd

To run tests once:

$ grunt test:client

Server Tests:

Server tests have been added using Mocha, Chai, and Proxyquire. To run the tests:

$ grunt test:server

Note:

$ grunt test

(will run all tests - both server and client)

benm's Issues

Missing code?

Is it implied that I'm to add Updating and Deletion functionalities in this example? I'm not seeing the code in the repo, or the the options after it's being served locally in the views and templates...

BTW awesome guide!

Parse error in handlebars\base.js

Not sure if this code is too old to run now, but when I follow the instructions on a windows machine I get stopped at:

$ grunt server
Running "clean:dev" (clean) task Running "browserify:app" (browserify) task

C:\Users\user1\benm\node_modules\handlebars\lib\handlebars\base.js:1
module Utils from "./utils";
^
ParseError: Unexpected identifier
Warning: Error running grunt-browserify. Use --force to continue. Aborted due to warnings.

Problem with starting server

Hell what is the cause of this error when I try to run grunt server
grunt build:dev

Running "clean:dev" (clean) task

Running "browserify:app" (browserify) task
>> /home/muwo/webdevelopment/webdev/feknuuz/client/templates/add.hbs:1
>>     <div class="add_contact">
>>     ^
>> ParseError: Unexpected token <
Warning: Error running grunt-browserify. Use --force to continue.

Aborted due to warnings
```.

``