ekita/ui-router

UI-Router for Nested Routing by the AngularUI Team!

UI-Router

Attention: UI-Router uses grunt >= 0.4.x make sure to upgrade your environment and read the Migration Guide.

Finally a de-facto solution to nested views and routing.

Main Goal

To evolve the concept of an Angular "Route" into a more general concept of a "State" for managing coarse application UI states.

Main Features

1. A state manager $stateProvider and $state, keeps state logic separate from routing logic.
2. Nested states (parent/child relationships).
3. Can set multiple views via named views. ui-view directive.
4. URL Routing
5. Backwards compatible with Angular v1 router
6. Various other nuggets of goodness

Resources

• In-depth Overview
• FAQ
• Sample App (Source)
• Generated Docs
• Latest build: angular-ui-states.min.js (uncompressed angular-ui-states.js)

Developing

Dependencies for building the solution and running tests:

• grunt-cli - run: $ npm install -g grunt-cli
• Then install development dependencies with: $ npm install

There is a number of targets in the gruntfile that is used to building the solution, documents etc.

• grunt: Perform a normal build, runs jshint and karma tests
• grunt build: Perform a normal build
• grunt dist: Perform a clean build and generate documentation
• grunt dev: Run dev server (sample app) and watch for changes, builds and runs karma tests on changes.