```
Serve a complete page for every URL and keep the same selector around the content you want Aura to update.
**2. Declare routes. Mark the links.**
```html
About
```
`extract` tells Aura which region to take from each complete HTML response. On the first flat page, Aura adopts the matching region already on screen instead of fetching it again.
**3. Start Aura once**
```js
import { AuraRouter } from '@auraui/router';
AuraRouter.install();
```
That is the upgrade: every URL still opens as a normal page, while marked links navigate through Aura after startup.
## Change the page. Keep the layout.
Nested routes keep shared UI mounted while the child view changes – useful for dashboards, workspaces, and settings screens.
```html
```
Direct nested URLs need matching outlet-shaped HTML and an `aura-router-ssr` marker. See the [nested layout recipe](./docs/recipes/nested.md).
## Add features when you need them
- [Lifecycle hooks](./docs/guide/05-lifecycle-and-data.md#lifecycle-hooks) – guard, load, ready, leave, and unmount
- [Prefetch and cache](./docs/recipes/prefetch-cache.md) – configure link prefetch and route-scoped view, data, or DOM cache policies
- [Authentication guards](./docs/recipes/auth.md) – protect client navigation without hiding server responsibilities
- [First-paint adoption](./docs/recipes/first-paint.md) – reuse flat or nested HTML on startup
- [404 handling](./docs/recipes/not-found.md) – keep client and server fallbacks honest
- [Programmatic navigation](./docs/guide/09-api-reference.md#programmatic-api) – navigate from application code
## Compatibility
Aura Router targets modern browsers with ES modules, Custom Elements, History API, and `fetch`. Parameterized routes require `URLPattern`.
It runs in the browser; it is not a Node SSR runtime. Your server or static host remains in control of the HTML response.
## Project
Current release: **0.3.0**
**Documentation:** [Guide](./docs/guide.md) · [What Aura is not](./docs/what-aura-is-not.md) · [Recipes](./docs/recipes/) · [MAGA](https://github.com/aura-ui/MAGA) · [Playground](./playground/) · [Known limitations](./LIMITATIONS.md)
**Development:** [Changelog](./CHANGELOG.md) · [Roadmap](./ROADMAP.md) · [Contributing](./CONTRIBUTING.md) · [Security](./SECURITY.md)
**Community:** [Article on DEV.to](https://dev.to/aura-ui/why-i-built-an-spa-router-for-html-and-web-components-25dm) · [GitHub Discussions](https://github.com/aura-ui/router/discussions) · [hello@aura-ui.dev](mailto:hello@aura-ui.dev) · [npm](https://www.npmjs.com/package/@auraui/router)
## License
MIT covers source code only – not the project name or logos. See [LICENSE](./LICENSE) and [TRADEMARKS.md](./TRADEMARKS.md).