📦 Zeba Academy Form Validator

A powerful, lightweight, and reusable form validation package for Flutter with clean architecture and Zeba Academy branding.

Built to simplify validation logic while keeping your codebase clean, scalable, and production-ready.

✨ Features

✔ Email, Password, Phone, and Name validators ✔ Clean and reusable validation functions ✔ Custom error messages with Zeba Academy branding ✔ Combine multiple validators easily ✔ Seamless integration with TextFormField ✔ Auto focus on first invalid field ✔ Developer-friendly API ✔ Zero bloat, high performance

🚀 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_form_validator: ^1.0.0

Then run:

flutter pub get

📖 Usage

1️⃣ Import Package

import 'package:zeba_academy_form_validator/zeba_academy_form_validator.dart';

2️⃣ Basic Validators

TextFormField(
  decoration: InputDecoration(labelText: "Email"),
  validator: ZebaValidators.email,
)

TextFormField(
  decoration: InputDecoration(labelText: "Password"),
  validator: ZebaValidators.password,
)

3️⃣ Combine Multiple Validators

validator: ZebaValidatorBuilder.combine([
  ZebaValidators.password,
  (value) =>
      value != null && value.contains("123")
          ? "Zeba Academy: Weak password"
          : null,
])

4️⃣ Form Validation with Auto Focus

final _formKey = GlobalKey<FormState>();

final emailFocus = FocusNode();
final passwordFocus = FocusNode();

ElevatedButton(
  onPressed: () {
    final isValid = ZebaFormHelper.validateAndFocus(
      formKey: _formKey,
      focusNodes: [emailFocus, passwordFocus],
    );

    if (isValid) {
      print("Form is valid 🚀");
    }
  },
  child: Text("Submit"),
)

🧠 Available Validators

Validator Description
email Validates email format
password Checks minimum length
phone Validates 10-digit phone number
name Ensures non-empty name

🎨 Custom Messages

All validation messages are pre-branded:

Zeba Academy: Enter a valid email
Zeba Academy: Password is required

You can extend or override them easily.

🧪 Testing

Run tests using:

flutter test

📂 Project Structure

lib/
 ├── zeba_academy_form_validator.dart
 └── src/
      ├── validators.dart
      ├── messages.dart
      ├── validator_builder.dart
      └── form_helper.dart

🔥 Future Enhancements

  • Confirm password validator
  • Async validation (API-based)
  • Localization support
  • Prebuilt UI components
  • Advanced validation rules

🤝 Contributing

Contributions are welcome!

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

📜 License

This project is licensed under the GPL License.

👨‍💻 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 no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, 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 courses: https://code.zeba.academy ➡ YouTube: https://www.youtube.com/@zeba.academy ➡ Instagram: https://www.instagram.com/zeba.academy/

❤️ Support

If you like this package, give it a ⭐ on GitHub and share it with others!

Thank you for visiting!

Libraries

zeba_academy_form_validator