# angular-ui-router

> State-based routing for AngularJS 1.x

Latest version **1.1.2** (published 2025-12-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install angular-ui-router
pnpm add angular-ui-router
yarn add angular-ui-router
bun add angular-ui-router
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2025-12-31 |
| First published | 2013-12-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=4.0.0 |
| Dependencies | 0 |
| Unpacked size | 3.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 13422 |
| Maintainers | nateabele, christopherthielen |

## Links

- npm: https://www.npmjs.com/package/angular-ui-router
- Repository: https://github.com/angular-ui/ui-router
- Homepage: https://ui-router.github.io
- Issues: https://github.com/angular-ui/ui-router/issues
- npm.io page: https://npm.io/package/angular-ui-router

## Recent versions

- 1.1.2 (latest) — 2025-12-31
- 1.0.30 — 2021-12-01
- 1.0.29 — 2020-12-21
- 1.0.28 — 2020-08-08
- 1.0.27 — 2020-07-21
- 1.0.26 — 2020-04-29
- 1.0.25 — 2020-02-04
- 1.0.24 — 2019-12-30
- 1.0.23 — 2019-10-02
- 1.0.22 — 2019-03-03
- 1.0.21 — 2019-03-03
- 1.0.20 — 2018-08-11
- 1.0.19 — 2018-07-20
- 1.0.18 — 2018-05-19
- 1.0.17 — 2018-05-19
- … 41 more at https://npm.io/package/angular-ui-router/versions

## README

# AngularUI Router  [![Build Status](https://github.com/angular-ui/ui-router/workflows/CI:%20UIRouter%20for%20AngularJS/badge.svg)](https://github.com/angular-ui/ui-router/actions?query=workflow%3A%22CI%3A+UIRouter+for+AngularJS%22)

**Note: this is the Angular 1.x source for UI-Router version 1.x.  If you are looking for the source for UI-Router 
version 0.x, it can be found [here](https://github.com/angular-ui/ui-router/tree/legacy)**

---


#### The de-facto solution to flexible routing in angular
---
**[Tutorials](https://ui-router.github.io/tutorials/)** |
**[API Docs](https://ui-router.github.io/docs/latest/)** |
**[Download stable](http://unpkg.com/@uirouter/angularjs@latest/release/angular-ui-router.js)** (or **[Minified](http://unpkg.com/@uirouter/angularjs@latest/release/angular-ui-router.min.js)**) **|**
**[Guide](https://ui-router.github.io/guide/) |**
**[Sample App](http://ui-router.github.io/resources/sampleapp/) |**
**[FAQ](https://github.com/angular-ui/ui-router/wiki/Frequently-Asked-Questions) |**
**[Report an Issue](https://github.com/angular-ui/ui-router/blob/master/CONTRIBUTING.md#report-an-issue) |**
**[Contribute](https://github.com/angular-ui/ui-router/blob/master/CONTRIBUTING.md#contribute) |**
**[Help!](http://stackoverflow.com/questions/ask?tags=angularjs,angular-ui-router) |**

---

Angular UI-Router is a client-side [Single Page Application](https://en.wikipedia.org/wiki/Single-page_application) 
routing framework for [AngularJS](http://angularjs.org).  
  
Routing frameworks for SPAs update the browser's URL as the user navigates through the app.  Conversely, this allows 
changes to the browser's URL to drive navigation through the app, thus allowing the user to create a bookmark to a 
location deep within the SPA.

UI-Router applications are modeled as a hierarchical tree of states. UI-Router provides a 
[*state machine*](https://en.wikipedia.org/wiki/Finite-state_machine) to manage the transitions between those 
application states in a transaction-like manner. 

## Get Started


- [UI-Router for Angular 1](https://ui-router.github.io/ng1)
- [UI-Router for Angular 2](https://ui-router.github.io/ng2)
- [UI-Router for React](https://ui-router.github.io/react)

## Resources

* [In-Depth Guide](https://github.com/angular-ui/ui-router/wiki)
* [Slides comparing ngRoute to ui-router](http://slid.es/timkindberg/ui-router#/)
* [UI-Router Extras / Addons for legacy (0.x)](http://christopherthielen.github.io/ui-router-extras/#/home) (@christopherthielen)
 
### Videos

* [Introduction Video](https://egghead.io/lessons/angularjs-introduction-ui-router) (egghead.io)
* [Tim Kindberg on Angular UI-Router](https://www.youtube.com/watch?v=lBqiZSemrqg)
* [Activating States](https://egghead.io/lessons/angularjs-ui-router-activating-states) (egghead.io)
* [Learn Angular.js using UI-Router](http://youtu.be/QETUuZ27N0w) (LearnCode.academy)

## Reporting issues and Contributing

Please read our [Contributor guidelines](CONTRIBUTING.md) before reporting an issue or creating a pull request.

---
_Source: https://npm.io/package/angular-ui-router · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._