About flutter-navigation
A Flutter navigation skill for developers designing routing around application state. It covers URL and deep-link handling, restoration, authentication redirects, and nested navigation while emphasizing preservation of existing routing choices.
Key features
- 01Assess routing and platform requirements
- 02Validate typed routes and parameters
- 03Design deterministic redirects
- 04Preserve back behavior across navigators
- 05Handle deep links and restoration
- 06Keep navigation effects out of build
Use cases
- 01Reviewing an existing Flutter router
- 02Adding deep links with safe destinations
- 03Supporting tab histories and nested navigation
- 04Testing redirects and restored navigation
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ thienqo/ flutter-skills --skill flutter-navigationAfter installing, type/flutter-navigationin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
evals/cases.jsonreferences/deep-link-and-restoration.mdnested-shell-navigation.mdDetails
From the project READMEFlutter Navigation
Model navigation as application state when URLs, deep links, restoration, or multiple navigators require it; use simpler imperative navigation for genuinely local flows.
Inspect first
Identify the current router, route ownership, authentication flow, tab/shell structure, supported platforms, URL requirements, and state restoration expectations. Preserve the existing routing package unless migration is requested.
Rules
- Keep route names, path parameters, and argument decoding typed or centrally validated.
- Make redirect logic deterministic and free of redirect loops.
- Preserve intended back behavior across Android system back, browser history, iOS gestures, nested navigators, and modals.
- Use nested navigation only for independent histories such as tab shells.
- Parse deep links into domain-safe state and define behavior for unknown or unauthorized destinations.
- Keep navigation side effects outside widget
build. - Do not place large domain objects directly in URLs or restoration state.
Verification
Test cold deep links, warm links, back/forward behavior, authentication redirects, invalid parameters, restoration where required, and each supported shell/tab history.
References
When tab shell patterns or independent back histories are in scope, follow the nested shell navigation reference. When handling deep links or state restoration, follow the deep link and restoration reference.