🎓 Student Management System (Flutter + Hive DB)

A modern and responsive Flutter application for managing student records across different classes (10th, 11th, 12th).
Built with Hive DB for fast and lightweight local storage, following Clean Architecture principles to ensure scalability, maintainability, and performance.

✨ Supports mobile, web, and desktop platforms, with a clean UI and complete CRUD functionality (Create, Read, Update, Delete).

🏗️ Architecture

lib/
├── core/                # Common utilities, DI container, error handling
├── data/                # Data sources + repository implementations
│   ├── datasources/
│   ├── models/
│   └── repositories/
├── domain/              # Business logic (entities, repositories, use cases)
│   ├── repositories/
│   └── usecases/
├── presentation/        # UI layer (pages, widgets, state management)
│   └── pages/
└── main.dart            # App entry point

📌 Highlights:

• Data Layer → Hive DB (local storage)
• Domain Layer → Use cases (add, update, delete, fetch students)
• Presentation Layer → Clean UI with Flutter

✨ Features

• ✅ Modern welcome and class selection screens
• ✅ CRUD (Create, Read, Update, Delete) students
• ✅ Persistent storage using Hive DB
• ✅ Class‑wise separation of students (10th, 11th, 12th)
• ✅ Beautiful and responsive UI
• ✅ Works on Flutter Web, Windows, and Mobile
• ✅ Structured with Clean Architecture
• ✅ Dependency Injection (InjectionContainer)
• ✅ Repository pattern for clean data access
• ✅ Error handling & validation (empty fields, duplicate roll numbers, invalid age)
• ✅ CI/CD with GitHub Actions (automatic tests on push/PR)
• ✅ Ready for unit tests with test/ folder
• ✅ Extensible → Authentication, charts, CSV export in future

---

📦 Hive Database

• 🐝 Used Hive for lightweight local database
• Created a Student model with @HiveType and @HiveField
• Registered adapters during app initialization
• Performed full CRUD operations:
  • Add student
  • View list of students
  • Edit student details
  • Delete student
• Each class (10th / 11th / 12th) stores data in a different Hive box

📷 Screenshots

Welcome Page Class Selection Page Class 10th(No Records) Class 10th(With Records) Class 12th(Adding the new Detials) Class 12th(Added Records) Class 12th(Update the Record) Class 12th(Updated Records)

---

🧰 Prerequisites

Before you begin, ensure you have the following installed:

• Flutter SDK
• Dart SDK
• Android Studio or VS Code with Flutter extension
• Chrome (for web) or Android/iOS emulator/device

⚙️ Installation

1. Clone the repo

   git clone https://github.com/seshathri044/student-management-system-flutter.git
   cd student-management-system-flutter

2. Install dependencies

flutter pub get

▶️ Running the App For Web (Chrome):

flutter run -d chrome

For Android/iOS Emulator:

flutter run

🚀 CI/CD Setup (GitHub Actions)

This repo includes a workflow that:

• ✅ Runs flutter test automatically on every push/PR
• ✅ Ensures code quality & reliability
  CI/CD Status:
  

🗂 Project Structure

.github/
    ├── workflows/            # CI/CD workflows
lib/
    ├── core/                 # Utilities, DI, error handling
    ├──  data/                # Data layer (Hive, repositories, models)
    ├──  domain/              # Use cases, entities, repository contracts
    ├──  presentation/        # UI screens
test/                         # Unit tests

🤝 Contributing

Contributions are welcome!

📄 License

This project is licensed under the MIT License.

👤 Author

• Seshathri
• 🚀 Aspiring Software Engineer | Passionate about Flutter & Java
• 🔗 GitHub Profile-https://github.com/seshathri044