/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.

hoangnguyen0403@hoangnguyen0403

GitHub

From plugin

agent-skills-standard

538200 skills1 MCP

Install

$ npx -y skills add hoangnguyen0403/agent-skills-standard --skill flutter-navigation --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/flutter-navigation

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.md

flutter-navigation.SKILL.md

name: flutter-navigation
description: 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.
metadata:
  triggers:
    files:
    - '**/*_route.dart'
    - '**/*_router.dart'
    - '**/main.dart'
    keywords:
    - Navigator
    - GoRouter
    - routes
    - deep link
    - go_router
    - AutoRoute

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'`