Navigation 3

Use this skill to work with Jetpack Navigation 3 in Compose codebases according to Android Developers guidance.

Navigation 3 is a Compose-first navigation library where application code owns navigation state. The back stack is a snapshot-state-backed list of keys; NavDisplay observes that list and renders matching NavEntry content.

Current AndroidX stable docs use androidx.navigation3:navigation3-*:1.1.1; check the target repository's version catalog before using newer alpha APIs.

Load Only What The Task Needs

• First-time project setup or adding Nav3 dependencies: read references/setup.md.
• Adding screens, routes, entry providers, or simple back-stack operations: read references/feature-navigation.md.
• Maintaining existing Nav3 code, modularizing routes, or changing feature boundaries: read references/maintenance-and-modularization.md.
• Bottom navigation, tabs, rail navigation, or preserving independent stacks: read references/multiple-back-stacks.md.
• Dialogs, bottom sheets, custom layouts, list-detail, adaptive panes, or metadata-driven UI: read references/scenes-overlays-adaptive.md.
• Animations, per-screen transitions, predictive back, or shared elements: read references/animations-and-transitions.md.
• Migration from Navigation 2, deep links, returning results, double navigation, state loss, or broken back behavior: read references/migration-and-troubleshooting.md.

Primary docs: