navpages 1.0.1

A flexible Flutter package for creating responsive navigation pages with integrated navigation rails and sidebars.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.1 - 2025-09-07

Fixed

• Fixed number of items in horizontal mode for tablets

1.0.0 - 2025-09-07

Added

• Initial release of NavPages package
• NavPages - Main widget for managing multiple pages with integrated navigation
• NavPage - Individual page widget with optional navigation bar
• NavRailButton - Customizable button component for navigation rails
• NavRail - Navigation rail component with expandable support
• Navbar - Customizable navigation bar with back button integration
• Responsive Design - Automatic adaptation between desktop and mobile layouts
• Navigation Controls - Navigator-like methods (push, pop, canPop, pushReplacement)
• Expandable Navigation - Collapsible navigation rail with customizable dimensions
• Action Buttons - Support for secondary actions in navigation rail
• Mobile Optimization - Overflow handling and menu systems for mobile devices
• Theme Integration - Full Material Design theme support
• Customizable Styling - Complete control over colors, dimensions, and appearance
• Example Application - Complete sample app demonstrating all features
• Comprehensive Documentation - Full API reference and usage examples
• Dartdoc Comments - Complete documentation for all classes and methods

Features

• Multi-page management with automatic state handling
• Responsive navigation that adapts to screen size
• Expandable/collapsible navigation rail
• Programmatic navigation control
• Customizable colors and styling
• Mobile-optimized layout with overflow handling
• Action buttons for secondary functionality
• Integration with Flutter's navigation system
• Material Design 3 support
• Comprehensive example application

Technical Details

• Built with Flutter SDK ^3.9.0
• Supports Flutter >=1.17.0
• Uses Material Design 3 components
• Responsive breakpoint at 768px width
• Automatic mobile/desktop layout switching
• State management with built-in navigation history
• Theme-aware color system
• Customizable dimensions and styling