📦 zeba_academy_stepper_form #

A powerful, customizable step-by-step form builder for Flutter with built-in progress tracking, validation, local state persistence, and smooth transitions.

✨ Features #

• 🧩 Step-by-step form UI
• 📊 Built-in progress indicator
• ✅ Per-step validation support
• 💾 Save & restore progress locally
• 🎞️ Smooth custom transitions (fade, slide)
• 🧱 Clean and reusable architecture
• ⚡ Lightweight & production-ready

🚀 Getting Started #

1. Add Dependency #

dependencies:
  zeba_academy_stepper_form: ^1.0.0

2. Import Package #

import 'package:zeba_academy_stepper_form/zeba_academy_stepper_form.dart';

🧠 Usage Example #

ZebaStepperForm(
  steps: [
    ZebaStep(
      title: "Name",
      content: TextField(
        decoration: InputDecoration(labelText: "Enter Name"),
      ),
      validator: () {
        // Add your validation logic
        return true;
      },
    ),
    ZebaStep(
      title: "Email",
      content: TextField(
        decoration: InputDecoration(labelText: "Enter Email"),
      ),
      validator: () => true,
    ),
    ZebaStep(
      title: "Complete",
      content: Center(child: Text("🎉 Done!")),
    ),
  ],
)

🧱 Core Components #

🔹 ZebaStepperForm #

Main widget to manage steps, navigation, transitions, and storage.

🔹 ZebaStep #

Represents each step with:

• title
• content
• validator

🔹 ZebaProgressIndicator #

Displays current step progress.

🔹 StepStorageService #

Handles saving and restoring step index using local storage.

🔹 ZebaTransitions #

Provides animation effects:

• Fade
• Slide

⚙️ Configuration #

🧪 Testing #

Run tests using:

flutter test

Make sure to test:

• Step navigation
• Validation behavior
• UI rendering
• Storage persistence

🔥 Roadmap #

• ❌ Form data persistence (not just step index)
• ❌ Custom button builders
• ❌ Step indicators (dots / icons)
• ❌ Theme customization
• ❌ Controller support (GetX / Provider)
• ❌ Advanced animations

🤝 Contributing #

Contributions are welcome!

1. Fork the repo
2. Create your feature branch
3. Commit changes
4. Open a pull request

👨‍💻 About Me #

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

🎓 Your all-in-one learning hub! #

🚀 Explore courses and resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated tutorials, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy ➡ Explore hands-on courses and resources at: https://code.zeba.academy ➡ Check out our YouTube for more tutorials: https://www.youtube.com/@zeba.academy ➡ Follow us on Instagram: https://www.instagram.com/zeba.academy/

Thank you for visiting! ❤️