nav_bar 0.0.1

A highly customizable, futuristic bottom navigation bar with particle effects and liquid animations.

🚀 Nav Bar

A premium Flutter package featuring 14 stunning, highly-customizable bottom navigation bar styles with advanced animations, particle effects, and haptic feedback.

✨ Features

• 🎨 14 Premium Styles: Liquid, Floating, Obsidian, Quantum, Prism, Hologram, Chronos, Synapse, Monolith, Singularity, Sumi, Cosmos, Kinetic
• 🎯 Deep Customization: Override any color or toggle any visual effect with customColors and effectToggles
• 🖼️ Custom Icons & Labels: Use standard IconData/String or provide custom Widgets
• ⚡ 7 Icon Animations: Scale, Rotate, Slide, Fade, Flip, Bounce, Magnetic
• 📳 Haptic Feedback: Physics-based animations with tactile response
• 🔔 Notification Badges: Built-in support with customizable counts
• 🎭 3 Pre-built Themes: Cyberpunk, Aurora, Molten (plus fully custom themes)
• ⚙️ Production Ready: Optimized rendering and smooth 60fps performance

📱 Preview

🚀 Installation

Add this to your pubspec.yaml:

dependencies:
  nav_bar: ^0.0.1

Then run:

flutter pub get

💡 Quick Start

import 'package:nav_bar/nav_bar.dart';

FuturisticNavBar(
  selectedIndex: _currentIndex,
  onItemSelected: (index) => setState(() => _currentIndex = index),
  style: NavBarStyle.liquid,
  theme: const FuturisticTheme.cyberpunk(),
  items: [
    NavBarItem(icon: Icons.home, label: 'Home'),
    NavBarItem(icon: Icons.search, label: 'Search'),
    NavBarItem(icon: Icons.favorite, label: 'Favorites'),
    NavBarItem(icon: Icons.person, label: 'Profile'),
  ],
)

🎨 Styles Gallery

Choose from 14 unique styles:

Style	Description
NavBarStyle.liquid	Liquid metal morphing effect
NavBarStyle.floating	Frosted glass floating pods
NavBarStyle.obsidian	Matte black with beam glow
NavBarStyle.quantum	Quantum ghost trails
NavBarStyle.prism	Chromatic light dispersion
NavBarStyle.hologram	Digital glitch effects
NavBarStyle.chronos	Mechanical clockwork
NavBarStyle.synapse	Neural network pulses
NavBarStyle.monolith	Minimalist architecture
NavBarStyle.singularity	Black hole gravity well
NavBarStyle.sumi	Japanese ink wash
NavBarStyle.cosmos	Deep space nebulae
NavBarStyle.kinetic	Mechanical tiles

🎯 Advanced Usage

Custom Icons & Labels

NavBarItem(
  customIcon: Image.asset('assets/custom_icon.png'),
  customLabel: Text('Gallery', style: myStyle),
)

Deep Customization

FuturisticNavBar(
  theme: FuturisticTheme.cyberpunk().copyWith(
    customColors: {
      'backgroundColor': Colors.black,
      'impactColor': Colors.cyanAccent,
      'tileActiveColor': Colors.purpleAccent,
    },
    effectToggles: {
      'showImpact': true,
      'showGrid': false,
      'showGlow': true,
    },
  ),
  // ... other properties
)

Icon Animations

FuturisticNavBar(
  iconAnimationType: IconAnimationType.bounce,
  // Options: scale, rotate, slide, fade, flip, bounce, magnetic
  // ... other properties
)

Notification Badges

NavBarItem(
  icon: Icons.notifications,
  label: 'Alerts',
  hasNotification: true,
  notificationCount: 5,
)

📚 Full Example

See the example directory for a complete demo app showcasing all features.

🛠️ Parameters

Parameter	Type	Description
selectedIndex	int	Currently selected tab index
onItemSelected	Function(int)	Callback when tab is tapped
items	List<NavBarItem>	Navigation items
theme	FuturisticTheme	Visual theme configuration
style	NavBarStyle	Navigation bar style
iconAnimationType	IconAnimationType	Icon animation type
showGlow	bool	Enable background glow (default: true)
showLiquid	bool	Enable liquid effects (default: true)
iconSize	double	Icon size (default: 26)
textStyle	TextStyle?	Custom label text style
glowStrength	double	Glow intensity (0.0-2.0)
borderWidth	double	Border thickness
blurSigma	double	Blur radius

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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

💬 Support

• 📧 Email: [[e-mail]]
• 🐛 Issues: GitHub Issues
• ⭐ Star this repo if you find it useful!

---

Made with ❤️ for the Flutter community