Android Navigation3 Shell And Deeplinks

Android Navigation 3 Shell And Deeplinks

Overview

Use this skill when the app already has, or needs, a shell-level navigation model beyond the core Navigation 3 primitives: root entry flow, authenticated shell flow, top-level tabs, deep links, gates, fullscreen flows, and explicit chrome policies.

Assume android-navigation3-core is either already installed or its patterns are already present in the workspace.

Workflow

1. Classify each destination before changing code.
   • Root flow destination
   • Shell top-level destination
   • Shell secondary or fullscreen destination
2. Model the shell explicitly.
   • Keep one top-level stack plus one substack per top-level destination when the product needs preserved tab history.
   • Keep shell chrome policy separate from destination UI.
3. Treat gating as navigation state, not as ad-hoc redirects.
   • Send users through login or mandatory gates using typed keys and explicit pending intent handling.