shared_side_bar_package 1.0.0

A responsive Flutter navigation package that adapts between sidebar and bottom navigation with smooth animations.

Shared Side Bar Package 🚀

A beautiful, responsive navigation package for Flutter that automatically adapts between sidebar (desktop/tablet) and bottom navigation (mobile) with smooth animations.

✨ Features

• Responsive Design - Automatically switches between sidebar and bottom navigation
• Smooth Animations - Beautiful transitions between layout states
• Customizable Theme - Consistent theming across all components
• Badge Support - Notification badges with count display
• High Performance - Optimized with ValueNotifier and efficient rebuilds
• Accessibility - Full semantic support and screen reader compatibility

🎯 Preview

Sidebar (Desktop/Tablet)

Bottom Navigation (Mobile)

📦 Installation

Add to your pubspec.yaml:

dependencies:
  shared_side_bar_package: ^1.0.0

🚀 Quick Start

import 'package:flutter/material.dart';
import 'package:shared_side_bar_package/shared_side_bar_package.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ResponsiveSideNavigationBar(
        child: MyHomePage(), // Your main content
        items: [
          NavItem(
            label: 'Home',
            path: '/home',
            icon: Icons.home_outlined,
            activeIcon: Icons.home_filled,
            badgeCount: 3,
          ),
          NavItem(
            label: 'Profile', 
            path: '/profile',
            icon: Icons.person_outline,
            activeIcon: Icons.person,
          ),
          // Add more items...
        ],
        selectedIndex: 0,
        onItemTapped: (index, path) {
          // Handle navigation
          print('Navigating to: $path');
        },
        user: SidebarUser(
          name: 'John Doe',
          email: '[e-mail]',
          onProfileTap: () => print('Profile tapped'),
        ),
        appName: 'MyApp',
      ),
    );
  }
}

🎨 Customization

Custom Theme

NavigationTheme(
  activeColor: Colors.deepPurple,
  inactiveColor: Colors.grey,
  backgroundColor: Colors.white,
  transitionDuration: Duration(milliseconds: 500),
)

Custom Header/Footer

ResponsiveSideNavigationBar(
  // ...
  sidebarHeader: (isExpanded, onToggle) => CustomHeader(),
  sidebarFooter: (isExpanded, user) => CustomFooter(user),
  logo: FlutterLogo(size: 40),
)

Responsive Breakpoint

ResponsiveSideNavigationBar(
  tabletBreakpoint: 1024, // Custom breakpoint
  // ...
)

📚 API Reference

Main Components

• ResponsiveSideNavigationBar - Complete responsive navigation shell
• ModernSidebar - Collapsible sidebar component
• CustomBottomNavBar - Animated bottom navigation
• NavItem - Navigation item data model
• NavigationTheme - Theming configuration

Models

• NavItem - Navigation items with icons, badges, and paths
• NavigationTheme - Colors, animations, and styling
• SidebarUser - User info for sidebar footer

Utilities

• NavigationUtils - Responsive helpers and theme adapters

🔧 Advanced Usage

Standalone Sidebar

ModernSidebar(
  items: navItems,
  selectedIndex: currentIndex,
  onItemTapped: (index, path) => navigate(path),
  user: currentUser,
)

Standalone Bottom Navigation

CustomBottomNavBar(
  items: navItems,
  selectedIndex: currentIndex,
  onItemTapped: (index, path) => navigate(path),
)

🤝 Contributing

We welcome contributions! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made by Sanket with ❤️ 🚀