designsystem/com.siddharth.kmp.designsystem/AdaptiveNavigationShell

AdaptiveNavigationShell

fun AdaptiveNavigationShell(destinations: ImmutableList<NavDestination>, modifier: Modifier = Modifier, content: @Composable () -> Unit)(source)

Adaptive top-level chrome: a bottom bar on a phone, a nav rail on a tablet or desktop, and a drawer where the window is wide enough to justify one. The layout decision belongs to the window size class, not to the platform, which is why this replaces per-platform branching rather than moving it somewhere tidier.

This is chrome, not routing. navigation-compose and navigation3 remain the router. The shell never navigates; it renders destinations and calls NavDestination.onSelect. Keeping that line sharp is what lets an app adopt the shell without touching its graph.

Lives in :designsystem rather than :app-shell for a hard reason: app-shell applies no Compose plugin and declares no wasmJs target, so a Compose UI dependency cannot go there without changing what that module is. app-shell is headless platform services.

Parameters

content

the destination's own screen. The shell adds no padding of its own — the scaffold already insets the content for whichever navigation affordance it chose.