# Flutter Navigation

> Implement route configuration, go_router/deep linking, and named routes in Flutter. Use for route declarations, route guards, and URL-to-screen mapping; defer transition-only animation, state-transfer/BLoC questions, auto_route-specific setup, and generic app-bar controls.

- Skill: `hoangnguyen0403/flutter-navigation` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add hoangnguyen0403/flutter-navigation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangnguyen0403/flutter-navigation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: HoangNguyen0403 (https://skillmd.com/u/hoangnguyen0403)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/hoangnguyen0403/flutter-navigation

---

# Flutter Navigation

## **Priority: P1 (HIGH)**


## Implementation Workflow

1. **Choose router** — Use `go_router` for modern, declarative routing.
2. **Define routes** — Use constants or code generation for route paths; never hardcode strings.
3. **Configure deep links** — Set up `AndroidManifest.xml` and the iOS URL-type settings for app URL schemes.
4. **Validate parameters** — Check parameters in `redirect` logic before navigation.
5. **Preserve tab state** — Use `StatefulShellRoute` or `IndexedStack` for bottom navigation.

### Route Configuration Example

See [implementation examples](references/implementation.md) for GoRouter configuration with parameter validation and redirects.

[Routing Patterns & Examples](references/routing-patterns.md)

## Anti-Patterns

- **No Manual URL Parsing**: Use `go_router` built-in parsing instead of `Uri.parse(url)`
- **No Manual Tab State Management**: Use `IndexedStack` or `StatefulShellRoute` to preserve state
- **No Unvalidated Deep Link IDs**: Always check existence in `redirect`
- **No Hardcoded Route Strings**: Use constants (e.g., `Routes.orders`) or code-gen instead of `'/orders'`

## Related Topics

flutter-design-system | flutter-notifications | mobile-ux-core

## Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:
- Android
- iOS URL-type