📦 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

Property	Description	Default
steps	List of steps	required
duration	Transition duration	300ms
enableStorage	Save progress locally	true

🧪 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!

Fork the repo
Create your feature branch
Commit changes
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! ❤️