rodfernandez/angularfun

Angular Fun

By Cary Landholt

About

• This is an attempt to play with the features of AngularJS using a structure to support large client-side applications, leverage the goodness of RequireJS, CoffeeScript, LESS, Grunt and Jasmine.
• Demonstrates controllers, services, directives, filters, and partials
• Uses the RequireJS text plugin to include directive partials in the minified output to reduce server requests
• Uses Jasmine to run unit tests
• Uses Grunt to put it all together

Prerequisites

• Must have Git installed
• Must have node.js (at least v0.8.1) installed with npm (Node Package Manager)
• Must have CoffeeScript node package installed globally. npm install -g coffee-script
• You can skip this step if you wish to run Grunt local to the project - Install the following Node.js modules via the terminal. This is a one-time task as the -g switch will install the modules globally. npm install -g grunt

Install Angular Fun

Enter the following commands in the terminal.

• git clone git://github.com/CaryLandholt/AngularFun.git
• cd AngularFun
• npm install
• grunt or "./node_modules/.bin/grunt" to run it local to the project

You are now ready to run the app. However, if you wish to run the app with optimizations (minification, etc.) turned on, enter the following command in the terminal. grunt prod This will create one JavaScript file and one CSS file to demonstrate the power of r.js, the build optimization tool for RequireJS.

Run It

• Navigate to the root of the project
• grunt server

Making Changes

• grunt dev will watch for any CoffeeScript (.coffee), Less (.less), or .template file changes. When changes are detected, the files will be linted, compiled, and ready for you to refresh the browser.

Running Tests

• Open /test/runner.html to run the unit tests using Jasmine.

To-Do

• Add many more unit tests :(
• Add more documentation :(
• Screencasts :)