FxShell class

Root layout for post-login home / dashboard / main flows.

Composes:

• FxScaffold (outer scaffold)
• Optional shared FxAppBar per FxPane.showAppBar
• FxDock bottom bar (FxSite.dock)
• FxDrawer / end drawer (FxSite.drawer, FxSite.endDrawer)
• Body: active FxPane.builder, switched with AnimatedSwitcher

State lives in fxShellCtrlProvider (FxShellCtrl). Panes are synced after the first frame so Riverpod is not written during build.

Nested scaffolds

If a pane uses its own Scaffold + AppBar, set FxPane.showAppBar to false for that pane. The shell then sets primary: false on the outer FxScaffold so the inner app bar receives correct status-bar padding.

Example

FxShell(
  initialPaneKey: 'home',
  panes: [
    FxPane(
      key: 'home',
      title: 'Home',
      icon: FxPaneState.onlyActive(Icons.home),
      sites: const [FxSite.dock],
      builder: (_) => const HomeTab(),
    ),
    FxPane(
      key: 'settings',
      title: 'Settings',
      showAppBar: false,
      builder: (_) => SettingsScaffold(), // owns its own AppBar
    ),
  ],
)