Zeba Academy Onboarding #

A production-ready Flutter onboarding package for creating beautiful app tours, feature highlights, coach marks, and resumable onboarding experiences.

✨ Features #

🚀 App Tours #

Create guided tours to introduce users to your application.

🎯 Feature Highlights #

Highlight important UI elements and new features.

💡 Coach Marks #

Provide interactive onboarding overlays with focused attention.

💾 Resume Support #

Automatically remembers completed onboarding using persistent storage.

🎨 Customizable Experience #

• Custom titles
• Descriptions
• Icons
• Multiple onboarding steps
• Easy integration

📦 Installation #

Add the package to your pubspec.yaml:

dependencies:
  zeba_academy_onboarding: ^0.0.1

Run:

flutter pub get

🚀 Getting Started #

Import the package:

import 'package:zeba_academy_onboarding/zeba_academy_onboarding.dart';

🔥 Basic Usage #

Create widget keys:

final homeKey = GlobalKey();
final profileKey = GlobalKey();

Create onboarding steps:

final steps = [

  OnboardingStep(
    key: homeKey,
    title: "Home Screen",
    description:
        "Your dashboard is available here.",
    icon: Icons.home,
  ),


  OnboardingStep(
    key: profileKey,
    title: "Profile",
    description:
        "Manage your account details here.",
    icon: Icons.person,
  ),

];

Wrap your screen:

ZebaOnboarding(

  steps: steps,

  child: Scaffold(

    body: Column(

      children: [

        Container(
          key: homeKey,
          child: const Text(
            "Home"
          ),
        ),


        Container(
          key: profileKey,
          child: const Text(
            "Profile"
          ),
        ),

      ],

    ),

  ),

);

🎯 Controller Actions #

Control onboarding manually.

Start #

controller.start();

Next #

controller.next();

Previous #

controller.previous();

Skip #

controller.skip();

Complete #

controller.complete();

💾 Resume Support #

The package stores onboarding completion state.

Save completion:

await OnboardingStorage.saveCompleted();

Check completion:

final completed =
await OnboardingStorage.completed();

Reset onboarding:

await OnboardingStorage.reset();

🏗️ Project Structure #

lib/

├── zeba_academy_onboarding.dart

└── src/

    ├── onboarding_step.dart
    ├── onboarding_controller.dart
    ├── onboarding_overlay.dart
    ├── onboarding_storage.dart
    ├── onboarding_tour.dart
    └── widgets/

        └── spotlight.dart

🧪 Testing #

Run package tests:

flutter test

🛠 Requirements #

Flutter:

>=3.10.0

Dart:

>=3.0.0

📌 Roadmap #

Future improvements:

• ❌ Custom animations
• ❌ Tooltip placement options
• ❌ Dark mode support
• ❌ Multiple onboarding sessions
• ❌ Gesture support
• ❌ Lottie animation support
• ❌ More storage providers

👨‍💻 About Me #

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more:

🌐 Website https://sufyanism.com/

💼 LinkedIn https://www.linkedin.com/in/sufyanism

🎓 Zeba Academy #

Your all-in-one learning hub! #

🚀 Explore courses and resources in coding, technology, and development.

Learn through:

• Practical tutorials
• Real-world projects
• Hands-on experience

Level up your development skills 💻✨

Website:

https://zeba.academy/

Coding Resources:

https://code.zeba.academy/

YouTube:

https://www.youtube.com/@zeba.academy

Instagram:

https://www.instagram.com/zeba.academy/

🤝 Contributing #

Contributions are welcome.

Steps:

1. Fork the repository

2. Create a branch:

git checkout -b feature/new-feature

3. Commit:

git commit -m "Add new feature"

4. Push:

git push origin feature/new-feature

5. Open a Pull Request.

📄 License #

This project is licensed under the GNU General Public License v3.0.

You are free to:

✔ Use ✔ Modify ✔ Distribute ✔ Improve

under GPL-3.0 terms.

See the LICENSE file for details.

❤️ Support #

If this package helps your Flutter projects, consider sharing it with the community.

Thank you for using Zeba Academy Onboarding 🚀