📊 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.

Libraries

zeba_academy_student_dashboard