Accela Angular Seed

An AngularJS starter project that uses some of the Automation 8.0 core components.

Version

1.0.0

Prerequisites

• NodeJS - for server-side package management, and to enable Grunt build automation
• Bower - for client-side package management (see "Install Bower and Grunt client" below)

Tech

• AngularJS - JavaScript MVC framework.

• angular-ui-router - provides flexible routing with nested views.

• lodash - A JavaScript utility library delivering consistency, modularity, performance, and extras.

• sprintf - sprintf implementation for the browser and node.js.

• stacktrace - Framework-agnostic, micro-library for getting stack traces in all web browsers.

• Grunt - for build automation and testing.

  • LESS - to enhance our CSS development experience.
  • JSHint - to ensure consistent coding practices.
  • WireDep - to inject Bower packages into the source code with Grunt.
  • Karma - to run unit tests.
  • Protractor - to run E2E browsers tests (see below).

Initial Steps

Install Bower, the Grunt client, and Protractor for E2E testing (the -g flag makes these globally available)

npm install -g bower
npm install -g grunt-cli
npm install -g protractor

Install NodeJS packages defined in "packages.json"

• These are used by the build tools, and are installed into the "node_modules" folder.

npm install

Install front-end JavaScript packages defined in "bower.json"

• These include AngularJS, and are installed into the "bower_components" folder.

bower install

Run grunt "default" task (defined in "gruntfile.js"

• Compiles .less files to .css, etc...

grunt

Testing

For localhost testing:

grunt web_server

• and browse to https://localhost:3000/index.html

For Unit testing:

• run "grunt web_server"
• then run "grunt karma:unit"

For Protractor E2E testing, run this from the command line:

• webdriver-manager update (not needed every time, but should be run the first time)
• webdriver-manager start
• then run "grunt web_server"
• then run "grunt protractor"