📦 Zeba Academy Navigator

A powerful and lightweight Flutter navigation toolkit built for modern apps.

It provides a clean and scalable navigation system with:

Route management Deep linking support Navigation history tracking Custom transitions Route guards Modular architecture 🚀 Features 🧭 Global navigation manager (ZebaNavigator) 🗺️ Simple route registration system (ZebaRoute) 🔗 Deep linking support (zeba://profile/10) 🛡️ Route guards for authentication control 🎬 Custom page transitions (fade included) 📜 Navigation history tracking ⚡ Lightweight and dependency-free core 🧩 Easy integration with Flutter apps 📦 Installation

Add dependency in pubspec.yaml:

dependencies: zeba_academy_navigator: ^1.0.0

Then install:

flutter pub get ⚙️ Setup

Initialize routes in main.dart:

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

void main() { ZebaNavigator.setup( appRoutes: ZebaRoute( path: '/home', builder: (_) => HomePage(), ), ZebaRoute( path: '/profile', builder: (_) => ProfilePage(), guard: AuthGuard(true), ), , );

runApp(const MyApp()); }

class MyApp extends StatelessWidget { const MyApp({super.key});

@override Widget build(BuildContext context) { return MaterialApp( navigatorKey: ZebaNavigator.navigatorKey, home: HomePage(), ); } } 🧭 Navigation Usage ➤ Push Route ZebaNavigator.push('/profile'); ➤ Pop Route ZebaNavigator.pop(); ➤ Current Route final route = ZebaNavigator.currentRoute(); 🔗 Deep Linking final link = ZebaDeepLink("zeba://profile/10");

ZebaNavigator.push(link.path);

Output:

/profile/10 🛡️ Route Guards

Protect routes using custom logic:

class AuthGuard extends ZebaRouteGuard { final bool loggedIn;

AuthGuard(this.loggedIn);

@override Future

Usage:

ZebaRoute( path: '/dashboard', builder: (_) => DashboardPage(), guard: AuthGuard(true), ) 🎬 Custom Transitions

Fade transition example:

ZebaFadeTransition( page: YourPage(), ); 📜 Navigation History print(ZebaNavigator.history); 🧪 Running Tests flutter test 📁 Project Structure lib/ ├── src/ │ ├── navigator_manager.dart │ ├── route_config.dart │ ├── route_guard.dart │ ├── deep_link.dart │ ├── transition.dart └── zeba_academy_navigator.dart 📈 Roadmap Nested navigation system Route parameters (/profile/:id) Navigation observers Bottom navigation support Advanced transition builder Web URL synchronization 👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me at sufyanism.com or connect on LinkedIn

🎓 Zeba Academy

🚀 Explore courses and resources in coding, tech, and development:

🌐 https://zeba.academy 💻 https://code.zeba.academy 📺 https://www.youtube.com/@zeba.academy 📸 https://www.instagram.com/zeba.academy/ 📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).