zeba_academy_core #

Shared core utilities package for the Zeba Academy Flutter Ecosystem.

zeba_academy_core provides reusable foundations used across all Zeba Academy packages and applications including models, API handling, logging, error management, and theme constants.

✨ Features #

• ✅ Common base models
• ✅ API response wrapper
• ✅ Centralized error handling
• ✅ Structured logging system
• ✅ Shared theme configuration
• ✅ Global constants & utilities
• ✅ Clean architecture ready
• ✅ Lightweight & scalable

📦 Installation #

Add dependency to your pubspec.yaml:

dependencies:
  zeba_academy_core: ^0.0.1

Then run:

flutter pub get

🚀 Usage #

Import the package:

import 'package:zeba_academy_core/zeba_academy_core.dart';

📡 API Response Wrapper #

Standardized API state handling.

final response = ApiResponse.success("Data loaded");

if (response.status == Status.success) {
  print(response.data);
}

States #

• Status.loading
• Status.success
• Status.error

❗ Error Handling #

Central exception system for consistent failures.

try {
  throw NetworkException("No Internet");
} catch (e) {
  final error = ErrorHandler.handle(e);
  print(error.message);
}

🪵 Logger #

Structured logging powered by logger package.

AppLogger.d("Debug message");
AppLogger.i("Info message");
AppLogger.w("Warning message");
AppLogger.e("Error message");

🎨 Theme System #

Colors #

Container(color: AppColors.primary);

Text Styles #

Text("Hello", style: AppTextStyles.heading);

App Theme #

MaterialApp(
  theme: AppTheme.lightTheme,
);

🔧 Constants #

print(AppConstants.appName);

🧱 Project Structure #

lib/
 ┣ zeba_academy_core.dart
 ┗ src/
    ┣ models/
    ┣ errors/
    ┣ logger/
    ┣ theme/
    ┗ utils/

🧪 Testing #

Run tests using:

flutter test

📈 Architecture Role #

This package acts as the foundation layer for:

• Authentication UI
• Student Dashboard
• LMS UI
• Exam Engine
• Feed Parser

All shared logic should live here to avoid duplication.

🤝 Contributing #

Contributions are welcome.

1. Fork the repository
2. Create a feature branch
3. Commit changes
4. Open a pull request

📄 License #

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

See the LICENSE file for details.

👨‍💻 Maintained By #

Zeba Academy

Building modular, scalable Flutter learning solutions.