Zeba Academy Auth UI

A production‑ready Flutter Authentication UI Kit providing modern, responsive, and customizable authentication screens for Flutter applications.

---

✨ Overview

zeba_academy_auth_ui is a professional authentication UI package designed to accelerate Flutter app development. It includes beautifully designed login, signup, OTP verification, forgot password flows, and reusable social login components.

Built with clean architecture, responsive layouts, and modern UI principles.

---

🚀 Features

✅ Modern Login Screen ✅ Signup / Registration Screen ✅ OTP Verification UI ✅ Forgot Password Flow ✅ Social Login Buttons (Google, Facebook, Apple ready) ✅ Fully Responsive Layouts ✅ Dark & Light Theme Support ✅ Customizable Components ✅ Production‑Ready Structure

---

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  zeba_academy_auth_ui: ^0.0.1

Then run:

flutter pub get

---

🧱 Project Structure

lib/
 └── src/
     ├── screens/
     │   ├── login_screen.dart
     │   ├── signup_screen.dart
     │   ├── otp_screen.dart
     │   └── forgot_password_screen.dart
     │
     ├── widgets/
     │   ├── auth_text_field.dart
     │   ├── auth_button.dart
     │   └── social_login_button.dart
     │
     └── theme/
         └── auth_theme.dart

---

🛠 Usage

Import Package

import 'package:zeba_academy_auth_ui/zeba_academy_auth_ui.dart';

Example App

import 'package:flutter/material.dart';
import 'package:zeba_academy_auth_ui/zeba_academy_auth_ui.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: const LoginScreen(),
    );
  }
}

---

🎨 Customization

All components are customizable:

AuthButton(
  text: "Login",
  onPressed: () {},
  color: Colors.blue,
)

You can override themes using your app theme or custom styles.

---

📱 Responsive Design

The UI automatically adapts to:

• Mobile phones
• Tablets
• Large screens
• Landscape orientation

Built using flexible layouts and media queries.

---

🔐 Authentication Logic

This package provides UI only.

You can connect it with:

• Firebase Authentication
• REST APIs
• Supabase
• Custom backend

---

🧪 Testing

Run tests using:

flutter test

Static analysis:

flutter analyze

---

🧩 Included Widgets

Widget	Description
LoginScreen	Modern login interface
SignupScreen	User registration UI
OtpScreen	OTP verification layout
ForgotPasswordScreen	Password recovery flow
AuthTextField	Styled input field
AuthButton	Primary action button
SocialLoginButton	Social auth buttons

---

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL‑3.0).

See the LICENSE file for details.

---

🤝 Contributing

Contributions are welcome!

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

---

🏢 Zeba Academy

Developed and maintained by Zeba Academy.

---

⭐ Support

If you like this package:

⭐ Star the repository 🐞 Report issues 💡 Suggest features

---

📌 Roadmap

• Animation enhancements
• Biometric login UI
• Multi‑factor authentication UI
• Prebuilt Firebase adapters

---