🚀 Zeba Academy Stepper

Advanced Stepper Widgets for Flutter

Vertical • Horizontal • Animated • Customizable

---

✨ Overview

Zeba Academy Stepper is a modern Flutter package that provides beautiful and customizable stepper widgets.

It helps developers build:

• Order tracking screens
• Progress flows
• Timeline experiences
• Multi-step forms
• Learning progress screens
• Activity history

---

⭐ Features

✅ Vertical Stepper Widget ✅ Horizontal Stepper Widget ✅ Smooth Progress Animations ✅ Custom Step Icons ✅ Custom Step Content ✅ Active Step Highlight ✅ Completed Step State ✅ Error Step State ✅ Pending Step State ✅ Material 3 Compatible ✅ Null Safety Support ✅ Lightweight Package

---

📦 Installation

Add dependency:

dependencies:
  zeba_academy_stepper: ^1.0.0

Run:

flutter pub get

---

🚀 Getting Started

Import the package:

import 'package:zeba_academy_stepper/zeba_academy_stepper.dart';

---

📱 Vertical Stepper

ZebaVerticalStepper(

steps: [

ZebaStep(
title: "Order Placed",
subtitle: "Your order was received",
status: StepStatus.completed,
),


ZebaStep(
title: "Processing",
subtitle: "Preparing your order",
status: StepStatus.active,
),


ZebaStep(
title: "Delivered",
status: StepStatus.pending,
),

],

)

---

📱 Horizontal Stepper

ZebaHorizontalStepper(

steps: [

ZebaStep(
title: "Account",
status: StepStatus.completed,
),


ZebaStep(
title: "Payment",
status: StepStatus.active,
),


ZebaStep(
title: "Complete",
status: StepStatus.pending,
),

],

)

---

🎨 Custom Theme

ZebaVerticalStepper(

theme: ZebaStepperTheme(

activeColor: Colors.blue,

completedColor: Colors.green,

errorColor: Colors.red,

),

steps: [

ZebaStep(
title: "Success",
status: StepStatus.completed,
)

],

)

---

📌 Step Status

StepStatus.pending

Waiting state

StepStatus.active

Current running step

StepStatus.completed

Finished step

StepStatus.error

Failed step

---

💡 Use Cases

🛒 E-Commerce

• Order tracking
• Delivery status
• Checkout progress

🎓 Education

• Course progress
• Lesson completion
• Learning paths

💼 Business Apps

• Workflow
• Approval process
• Task tracking

---

🛠 Requirements

Flutter:

>= 3.0.0

Dart:

>= 3.0.0

---

🤝 Contributing

Contributions are welcome.

Steps:

1. Fork repository

2. Create branch

git checkout -b feature/new-feature

3. Commit changes

git commit -m "Add new feature"

4. Push changes

git push origin feature/new-feature

5. Create Pull Request

---

🐛 Issues

Found a bug?

Create an issue and share:

• Problem description
• Steps to reproduce
• Flutter version

---

👨‍💻 About Me

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

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
• Development

Learn through:

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

---

Links

🌐 Website:

https://zeba.academy

💻 Coding Resources:

https://code.zeba.academy

▶ YouTube:

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

📸 Instagram:

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

---

📄 License

This project is licensed under the:

GNU General Public License v3.0

You are free to:

• Use the package
• Modify the source
• Share improvements

Conditions:

• Modified versions must remain GPL licensed
• License notices must be kept
• Source code must remain available

See LICENSE file for details.

---

Made with ❤️ for Flutter developers.

Zeba Academy Stepper 🚀