Navigation Shell Widget
Component Detail
User Interface
high complexity
mobile
0
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
The top-level scaffold widget that wraps all tab branches using Flutter's StatefulShellRoute. It hosts the Bottom Navigation Bar, an AppBar with a hamburger menu triggering a Drawer for secondary destinations (Settings), and delegates content rendering to the active branch child widget.
navigation-shell-widget
Responsibilities
- Wrap app content in a consistent scaffold with AppBar and bottom nav
- Integrate Drawer widget for hamburger menu / Settings access
- Delegate branch rendering to StatefulShellRoute children
- Apply role-aware visibility of nav items via Riverpod providers
- Handle deep link navigation triggered by push notifications
Interfaces
build(BuildContext context)
openDrawer()
closeDrawer()
navigateToBranch(int index)
applyRoleFilter(UserRole role)
handleDeepLink(Uri uri)