📊 zeba_academy_student_dashboard #

A production‑ready Flutter component library for building modern student dashboards in LMS, school, academy, and education apps.

This package provides reusable UI widgets designed with scalability, clean architecture, and customization in mind.

✨ Features #

• 👤 Profile Header
• 📈 Statistics Cards
• 📘 Course Progress Indicators
• 🕒 Activity Timeline
• 📅 Attendance Tracker UI
• 🎨 Theme‑friendly widgets
• 📱 Responsive layouts
• ✅ Test‑safe components (no network dependency)

📦 Installation #

Add dependency in your pubspec.yaml:

dependencies:
  zeba_academy_student_dashboard:
    path: ../zeba_academy_student_dashboard

Then run:

flutter pub get

🚀 Usage #

Import the package:

import 'package:zeba_academy_student_dashboard/zeba_academy_student_dashboard.dart';

👤 Profile Header #

Displays student avatar, name, and enrolled course.

ProfileHeader(
  name: "Sarvesh",
  course: "Flutter Development",
  imageUrl: "https://example.com/avatar.png",
)

Test‑Safe Usage #

ProfileHeader(
  name: "Sarvesh",
  course: "Flutter Development",
  imageProvider: AssetImage('test/test_image.png'),
)

📊 Stats Card #

Reusable statistic widget for dashboard metrics.

StatsCard(
  title: "Completed Courses",
  value: "12",
  icon: Icons.book,
)

📘 Course Progress Card #

Shows learning progress with percentage indicator.

CourseProgressCard(
  courseName: "Flutter Masterclass",
  progress: 0.75,
)

🕒 Activity Timeline #

Displays recent student activities.

ActivityTimeline(
  activities: [
    ActivityModel(
      title: "Assignment Submitted",
      description: "UI Design Assignment",
      date: DateTime.now(),
    ),
  ],
)

📅 Attendance Tracker #

Visual attendance grid.

AttendanceTracker(
  attendance: [
    AttendanceModel(date: DateTime.now(), present: true),
  ],
)

🧱 Package Structure #

lib/
 ├── zeba_academy_student_dashboard.dart
 └── src/
     ├── models/
     └── widgets/

🧪 Testing #

Run tests using:

flutter test

Widgets are designed to avoid network calls during testing by allowing custom ImageProvider injection.

🎨 Customization #

All widgets follow Flutter theming:

• Uses Theme.of(context) text styles
• Supports light & dark themes
• Easily extendable

🛣️ Roadmap #

• Dashboard Layout Widget
• Animated Components
• Theme Extension System
• Desktop/Web Responsiveness
• Example Application

🤝 Contributing #

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your 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 reusable tools for modern education platforms.