mean-vagrant

An Ubuntu 12.04 Vagrant VM (64-bit) for developing web applications on the MEAN stack

Prerequisites

• VirtualBox
• Vagrant

VM Environment

What's provisioned in the VM

• Ubuntu 12.04 (64-bit): Linux OS
• MongoDB: document NoSQL database
• Node: server-side JavaScript platform
• Bower: front-end package manager for the web
• Grunt: JavaScript task runner
• Supervisor: supervisor script for Node that listens for changes in the directory and re-launches Node when a change is made; it makes Node development a lot quicker

See provision.sh for more details

Node packages

• ExpressJS: web application framework for Node
• Jade: Node template engine
• Mongoose: MongoDB object modeling for Node

See package.json for more details

Bower packages

• AngularJS: JavaScript MVW framework
• Bootstrap: collection of HTML and CSS design templates
• Font Awesome: free icon library for Bootstrap
• jQuery: JavaScript library for HTML DOM manipulation

See bower.json for more details

Setup

1. Make sure you have VirtualBox and Vagrant installed (see Prerequisites)
2. Clone this repository and cd into the directory
   • Launch the VM by typing vagrant up
     • When this command is executed, the VM is initialized (see VM Environment)
     • Note that this step may take some time to complete
3. SSH into the VM by typing vagrant ssh
   • The repository files on the host machine are also shared with the VM; type cd /vagrant to navigate to the shared folder
   • Install the Node and Bower packages
     • To install the Node packages, type npm install
     • To install the Bower packages, type bower install
   • Seed MongoDB with a sample user by typing grunt dbseed (see Gruntfile.js)
4. Launch the Node app
   • You can launch the Node app in 2 ways:
     • Simply type node app.js
     • Or type supervisor app.js to use the Node supervisor script
   • Navigate to localhost:3000. The app should be up and running!