android-navigation

name	android-navigation
description	Implement screen routes and deep-link/App Link routing with Jetpack Compose Navigation on Android. Use when the primary task is Compose route configuration or external URL routing; defer typed-route APIs, XML/fragments, generic back-stack, and transition questions to their specific navigation skills.
metadata	{"triggers":{"files":["**/*Screen.kt","**/*Activity.kt","**/NavGraph.kt"],"keywords":["NavController","NavHost","composable","navArgument","deepLinks"]}}

Android Navigation (Jetpack Compose)

Priority: P2 (MEDIUM)

Guidelines

• Library: Use androidx.navigation:navigation-compose.
• Type Safety: Use sealed classes for routes, never raw strings.
• Deep Links: Configure intent-filter in Manifest and deepLinks in NavHost.
• Validation: Validate arguments (e.g., proper IDs) before loading content.

Anti-Patterns

• No String Routes: Use Screen.Product.route instead of "product/$id".
• No Unvalidated Deep Links: Check resource existence before rendering.
• No Missing Manifest: Deep links require autoVerify=true intent filters.

References

• Navigation Patterns