# @equinor/mad-navigation

> Navigation package built on top of React Navigation

Latest version **0.7.5** (published 2026-08-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @equinor/mad-navigation
pnpm add @equinor/mad-navigation
yarn add @equinor/mad-navigation
bun add @equinor/mad-navigation
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.7.5 |
| Published | 2026-08-25 |
| First published | 2023-09-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 43.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Equinor Mobile App Delivery team |
| Maintainers | anjalipandit, haakonsvane |
| Keywords | navigation, react native, react navigation, typescript |

## Links

- npm: https://www.npmjs.com/package/@equinor/mad-navigation
- Homepage: https://github.com/equinor/mad/
- Issues: https://github.com/equinor/mad/issues
- npm.io page: https://npm.io/package/@equinor/mad-navigation

## Dependencies (1)

- [warn-once](https://npm.io/package/warn-once.md) ^0.1.1

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 0.7.5 (latest) — 2026-08-25
- 0.7.4 — 2026-07-06
- 0.7.3 — 2026-06-22
- 0.7.2 — 2026-06-05
- 0.7.1 — 2026-05-29
- 0.7.0 — 2026-05-19
- 0.6.1 — 2025-10-30
- 0.6.0 — 2025-08-25
- 0.5.1 — 2024-12-13
- 0.5.0 — 2024-12-02
- 0.4.1 — 2024-11-28
- 0.4.0 — 2024-11-20
- 0.3.2 — 2024-07-31
- 0.3.1 — 2024-05-08
- 0.3.0 — 2024-02-01
- … 20 more at https://npm.io/package/@equinor/mad-navigation/versions

## README

# Mad Navigation

Mad Navigation is a layer on top of React Navigation that provides additional features to provide a
better experience for developers.

### Features

-   Display custom sub-headers automatically on screens.
-   Add onRouteChange prop to navigation containers

### Docs

For more detailed information about how to use the package, head to our
[documentation page](https://equinor.github.io/mad/docs/mad-navigation/introduction)

### Development

This package has custom navigators created by following
[this guide](https://reactnavigation.org/docs/custom-navigators). If you want to add additional
navigators or update the current navigators to be in sync with React Navigation’s navigators, follow
these steps:

1. Go to
   [React Navigation’s repository](https://github.com/react-navigation/react-navigation/tree/main/packages)
   and find the navigator you want to copy (usually located within `package-name/src/navigators`
   directory). Copy the source code.
2. paste the source code into this package and update imports. Imports that are not provided by the
   react navigation package should be created manually (usually only the `XNavigationConfig`). The
   props can also be recreated by exported types from react navigation + your copied
   `XNavigationConfig`.
3. Modify the `descriptors` using the `createMadDecorators` function.
4. Use the modified descriptors instead of the original descriptors in the return function

---
_Source: https://npm.io/package/@equinor/mad-navigation · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._