voo_navigation_bar library

Bottom navigation bar components for Flutter.

This package provides bottom navigation widgets that can be used standalone or as part of the voo_navigation adaptive navigation system.

Classes

VooActionNavigationItem
Configuration for an action navigation item that displays a modal when tapped.
VooActionNavItem
A navigation item that displays an action button with a modal popup.
VooAppBarConfig
Configuration for app bar customization on a per-page basis.
VooAppBarLeading
App bar leading widget that handles menu, back button, or custom widget
VooAppBarTitle
App bar title widget with animated transitions
VooAvatar
A reusable avatar widget that displays an image, initials, or custom widget
VooAvatarData
Data class for avatar configuration
VooAvatarGroup
A group of overlapping avatars
VooBackgroundIndicator
Background indicator widget for navigation items
VooBadge
A versatile badge widget for displaying counts, status indicators, and labels
VooBadgeWrapper
A widget that positions a badge on top of its child
VooBreadcrumbItem
Represents a breadcrumb item for hierarchical navigation
VooBreadcrumbs
A breadcrumbs navigation widget
VooBreadcrumbsConfig
Configuration for breadcrumbs
VooBreadcrumbsStyle
Style configuration for breadcrumbs
VooBreakpoint
Defines responsive breakpoints for adaptive layouts
VooCollapseState
InheritedWidget that provides collapse state to descendants.
VooCollapseToggle
Minimal collapse/expand toggle button for navigation drawer/rail.
VooCombinedSwitcherNavItem
A combined switcher that merges context switching and org/profile switching into a single navigation item.
VooContextItem
Represents a context item for the context switcher component.
VooContextSwitcher
Context switcher widget for switching between contexts (projects, workspaces, etc).
VooContextSwitcherBottomSheet
Bottom sheet widget for the context switcher.
VooContextSwitcherCard
Card component for the context switcher (closed state).
VooContextSwitcherCardData
Data passed to custom card builder.
VooContextSwitcherConfig
Configuration for the context switcher component.
VooContextSwitcherExpandableNavItem
A context switcher navigation item that matches the expandable nav bar design.
VooContextSwitcherModal
Modal component for the context switcher (open state).
VooContextSwitcherModalData
Data passed to custom modal builder.
VooContextSwitcherNavItem
A navigation item widget that displays the context switcher.
VooContextSwitcherStyle
Style configuration for the context switcher component.
VooDotBadge
Dot badge widget for navigation items
VooDropdownChildItem
Dropdown child item widget
VooDropdownChildren
Dropdown children widget that displays child navigation items
VooDropdownHeader
Dropdown header widget for expandable navigation items
VooEdgeIndicator
Left edge accent bar indicator for selected items
VooExpandableNavItem
VooExpandableNavItemLayout
Shared layout constants for expandable nav items. Using atomic design to ensure consistency across all nav item types.
VooExpandableNavModal
A modal overlay that appears above the navigation bar.
VooHeaderConfig
Configuration for the navigation header
VooLineIndicator
Line indicator widget for navigation items
VooMobileAppBar
Mobile app bar molecule - a simpler app bar specifically for mobile layouts
VooModernBadge
Modern badge widget for navigation items
VooModernIcon
Modern icon widget with badge support for custom navigation
VooMultiSwitcher
Multi-switcher widget combining organization and user switching.
VooMultiSwitcherActionTile
Action tile for the multi-switcher modal (Settings, Logout, etc.).
VooMultiSwitcherBottomSheet
Bottom sheet widget for the multi-switcher.
VooMultiSwitcherCard
Card component for the multi-switcher (closed state).
VooMultiSwitcherCardData
Data passed to custom card builder.
VooMultiSwitcherConfig
Configuration for the multi-switcher component.
VooMultiSwitcherCreateButton
Create button for adding new organizations or users.
VooMultiSwitcherExpandableNavItem
A multi-switcher (org/user) navigation item that matches the expandable nav bar design.
VooMultiSwitcherModal
Modal component for the multi-switcher (open state).
VooMultiSwitcherModalData
Data passed to custom modal builder.
VooMultiSwitcherNavItem
A navigation item widget that displays the multi-switcher (org/user).
VooMultiSwitcherOrganizationSection
Organization section for the multi-switcher modal.
VooMultiSwitcherOrgTile
Organization tile for the multi-switcher modal.
VooMultiSwitcherStyle
Style configuration for the multi-switcher component.
VooMultiSwitcherUser
Represents a user account for the multi-switcher component.
VooMultiSwitcherUserInfoTile
Current user info tile showing name, email, and status.
VooMultiSwitcherUserSection
User section for the multi-switcher modal.
VooMultiSwitcherUserTile
User tile for the multi-switcher modal.
VooNavigationAnimations
Navigation animation utilities
VooNavigationBadge
Badge widget for navigation items
VooNavigationBar
An expandable bottom navigation bar with pill-shaped design.
VooNavigationConfig
Configuration for the adaptive navigation system
VooNavigationDestination
Represents a single navigation destination with support for badges, dropdowns, and customization
VooNavigationHelper
Helper utilities for navigation
VooNavigationIcon
Animated navigation icon with selected state transitions
VooNavigationInherited
InheritedWidget to pass navigation configuration down the widget tree
VooNavigationSection
Represents a group of navigation items with a title and optional styling.
VooNavigationTheme
Theme configuration for navigation visual styling
VooNavigationTokens
Navigation-specific design tokens for consistent styling across drawer, rail, and bottom navigation components.
VooNavigationTypeHelper
Helper class for determining navigation type based on screen size
VooNotificationAction
Action button for a notification
VooNotificationItem
Represents a notification item for the notifications bell
VooNotificationsBell
A notification bell with dropdown list
VooNotificationsBellConfig
Configuration for the notifications bell
VooNotificationsBellStyle
Style configuration for the notifications bell
VooOrganization
Represents an organization for the organization switcher
VooOrganizationSwitcher
A dropdown switcher for selecting between organizations
VooOrganizationSwitcherConfig
Configuration for the organization switcher
VooOrganizationSwitcherStyle
Style configuration for the organization switcher
VooPageConfig
Configuration for page-level scaffold overrides.
VooPillIndicator
Pill-shaped indicator widget for navigation items
VooProfileMenuItem
Menu item for profile dropdown
VooQuickAction
Represents a quick action item for the quick actions menu
VooQuickActions
A quick actions menu with customizable trigger
VooQuickActionsConfig
Configuration for the quick actions menu
VooQuickActionSection
Represents a section of quick actions with a label and optional horizontal scrolling
VooQuickActionsMenuContent
Menu content for quick actions dropdown
VooQuickActionsSectionLayout
A widget that renders a section of quick actions with a label header and optional horizontal scrolling.
VooQuickActionsSectionsLayout
A widget that renders multiple sections of quick actions
VooQuickActionsStyle
Style configuration for the quick actions menu
VooScaleIndicator
Custom indicator widget with scale animation
VooScrollableBreadcrumbs
A horizontal scrollable breadcrumbs widget for long paths
VooSearchAction
Represents a search action for the search bar
VooSearchBar
A search bar with navigation filtering and global search capabilities
VooSearchBarConfig
Configuration for the search bar
VooSearchBarStyle
Style configuration for the search bar
VooSearchField
A styled search input field with keyboard shortcut support
VooStackedAvatars
Stacked avatars widget showing organization logo with user avatar overlay.
VooStatusBadge
A status badge for showing online/offline/busy states
VooTextBadge
Text badge widget for navigation items
VooThemedNavContainer
A themed container for navigation components
VooUserProfileConfig
Configuration for the user profile displayed in navigation drawer/rail footer.
VooUserProfileFooter
Modern user profile footer for navigation drawer/rail Displays user avatar, name, email with dropdown actions
VooUserProfileModalData
Data passed to custom modal builder for user profile.
VooUserProfileNavItem
A user profile navigation item that matches the expandable nav bar design.

Enums

VooActionItemPosition
Position of the action item in the expandable bottom navigation bar.
VooContextSwitcherPosition
Position of the context switcher in the navigation
VooExpandableLabelPosition
VooLineIndicatorPosition
Position for line indicators
VooMultiSwitcherPosition
Position of the multi-switcher in the navigation
VooNavigationType
Enum defining the type of navigation layout
VooOrganizationSwitcherPosition
Position of the organization switcher in the navigation
VooQuickActionsPosition
Position of the quick actions in the navigation
VooSearchBarPosition
Position of the search bar in the navigation
VooStatus
Status states for the status badge
VooTransitionType
Transition types for page routes
VooUserProfilePosition
Position of the user profile in the mobile bottom navigation bar.
VooUserStatus
User status options for profile footer

Mixins

ExpandableNavModalMixin<T extends StatefulWidget>
Helper mixin for nav items that show overlay modals

Extensions

VooNavigationTokensTheme on BuildContext
Extension methods for applying navigation tokens with theme awareness.
VooNavigationTypeExtension on VooNavigationType
Extension methods for VooNavigationType

Functions

showContextSwitcherBottomSheet({required BuildContext context, required VooContextSwitcherConfig config, required ValueChanged<VooContextItem> onContextSelected}) → void
Shows the context switcher as a bottom sheet modal.
showMultiSwitcherBottomSheet({required BuildContext context, required VooMultiSwitcherConfig config}) → void
Shows the multi-switcher as a bottom sheet modal.

Typedefs

VooContextItemsBuilder = List<VooNavigationDestination> Function(VooContextItem? context)
Callback that builds navigation items based on the selected context.