zeba_academy_stepper_form 1.0.0

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

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

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! ❤️