---
title: "UI-Router for AngularJS (1.x)"
layout: single
excerpt: "The defacto standard for routing in AngularJS"
sitemap: true
permalink: /ng1/
---
{% include toc icon="columns" title="AngularJS (1.x)" %}

<center>
<img src="/https/raw.githubusercontent.com/images/logos/angular1.png">
<br /><img src="https://img.shields.io/npm/v/@uirouter/angularjs.svg?label=@uirouter/angularjs&maxAge=3600">
<br /><iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=angular-ui&repo=ui-router&type=fork&count=true&size=large" frameborder="0" scrolling="0" width="160px" height="30px"></iframe><iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=angular-ui&repo=ui-router&type=star&count=true&size=large" frameborder="0" scrolling="0" width="160px" height="30px"></iframe>
</center>

## About

UI-Router is the defacto standard for routing in AngularJS.
Influenced by the core angular router `$route` and the Ember Router,
UI-Router has become the standard choice for routing non-trivial apps in AngularJS (1.x).

## Getting UI-Router

The UI-Router package is distributed using [npm](https://www.npmjs.com/), the node package manager.

```
npm install --save @uirouter/angularjs
```

Other examples:

- Via command line
  - Adding a specific version to your project: `npm install --save @uirouter/angularjs@1.0.7`

- From <http://unpkg.com> via a `<script>` tag in your html:
  - Latest stable version: `<script src="//unpkg.com/@uirouter/angularjs/release/angular-ui-router.min.js"></script>`
  - A specific version: `<script src="//unpkg.com/@uirouter/angularjs@1.0.7/release/angular-ui-router.min.js"></script>`
  - A legacy version: `<script src="//unpkg.com/angular-ui-router@0.4.2/release/angular-ui-router.js"></script>`

- From bower:
  - Latest stable version: `bower install angular-ui-router`
  - A specific version: `bower install angular-ui-router#1.0.7`
  - A legacy version: `bower install angular-ui-router#0.3.1`

Note: bower releases are considered 'legacy' and are managed at <https://github.com/angular-ui/angular-ui-router-bower>

## Tutorials

Learn UI-Router by following our tutorials.

- [Hello World](/tutorial/ng1/helloworld)
- [Hello Solar System](/tutorial/ng1/hellosolarsystem)
- [Hello Galaxy](/tutorial/ng1/hellogalaxy)


## Sample application

The [UI-Router Sample App](/resources/sampleapp) is a non-trivial UI-Router application.

## Development

To fix a UI-Router bug, or create an enhancement, follow these steps:

The Typescript source code for UI-Router for Angular (2+) can be found at <https://github.com/angular-ui/ui-router>
UI-Router for AngularJS (1.x) depends on UI-Router Core, which can be found at <https://github.com/ui-router/core>

To get started:

```
mkdir uirouter
cd uirouter
git clone https://github.com/angular-ui/ui-router angularjs
git clone https://github.com/ui-router/core core
cd core
npm install
npm link
npm run build

cd ../angularjs
npm install
npm link @uirouter/core
npm run build
```

To create a UI-Router bundle to test a bug fix against your app, run `npm run package`
You can then run `npm link`, and then run `npm link @uirouter/angularjs` in your app's directory.
Your app's npm dependency will use the local `@uirouter/angularjs` package that you just built.

Alternatively, bundles are also created in `release/angular-ui-router.js`.