gt_navigation 1.0.0
gt_navigation: ^1.0.0 copied to clipboard
A production-ready Flutter navigation package with middleware, deep linking, nested navigation, custom transitions, and type-safe routing.
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.0 - 2025-12-27 #
Added #
Core Navigation
AppRoutersingleton for context-free navigation throughout the appAppRouteclass with regex-based path matching for dynamic routes (e.g.,/user/:id)AppRouteArgumentswith type-safe getters (getString,getInt,getDouble,getBool)- Multiple navigation modes:
push,pushReplacement,pushAndRemoveUntil,pushAndRemoveAll
Route Management
Routesclass for centralized, type-safe route definitions- Path parameter extraction from dynamic routes
- Query parameter support
Middleware System
AppMiddlewareabstract class for navigation guardsAuthMiddlewareexample implementation for authentication checks- Automatic redirect on blocked navigation
Transitions
- 7 built-in transition types:
material,cupertino,fade,slide,scale,rotation,none - Configurable transition direction:
leftToRight,rightToLeft,topToBottom,bottomToTop - Custom transition duration
Deep Linking
DeepLinkConfigfor scheme and host configuration- Automatic deep link parsing and routing
handleDeepLinkandhandleNotificationRoutemethods
UI Helpers
openDialogfor context-free dialog displayopenBottomSheetfor context-free bottom sheet displayNestedNavigatorwidget for tabs and multi-pane layouts
Observability
AppRouterObserverfor route lifecycle trackingNavigationLoggerfor debug logging- Built-in navigation stack tracking
Memory Management
- Stack size limiting to prevent unbounded growth
- Proper dispose method for cleanup