Shafeea Student is the official mobile application for Shafeea Academy, a comprehensive educational platform designed to empower students in their learning journey. Built with Flutter, the app provides a seamless, high-performance experience for tracking academic progress, accessing religious resources (including a full Quran reader), and managing daily educational activities.
- 📱 User-Friendly Dashboard: A centralized hub for students to view their progress and upcoming tasks.
- 📖 Integrated Quran Reader: High-quality digital Quran with custom fonts and specialized reading modes.
- 📊 Daily Tracking: Detailed logging and visualization of daily academic and spiritual activities.
- 🌓 Dynamic Theming: Full support for light and dark modes with a premium aesthetic.
- 🌍 Localization: Optimized for Arabic-speaking users with full RTL (Right-to-Left) support.
- 🔒 Secure Authentication: Robust login system with device-aware security.
| Category | Technology |
|---|---|
| Framework | Flutter |
| State Management | BLoC / Cubit |
| Navigation | GoRouter |
| Dependency Injection | Injectable / GetIt |
| Networking | Dio |
| Database | SQLite (sqflite) |
| Charts | FL Chart |
lib/
├── config/ # App configuration (DI, Routes, Themes, L10n)
├── core/ # Shared core logic (Network, Errors, UseCases)
├── features/ # Feature-based modules
│ ├── app/ # App-wide logic and setup
│ ├── auth/ # Authentication and User Management
│ ├── daily_tracking/ # Progress and activity tracking
│ ├── home/ # Main dashboard and core features
│ └── settings/ # User preferences and app settings
├── routes/ # Navigation routing definitions
├── shared/ # Reusable UI components and widgets
└── main.dart # App entry point
- Flutter SDK (latest stable version)
- Dart SDK
- Android Studio / VS Code with Flutter extensions
-
Clone the repository:
git clone https://github.com/your-username/shafeea_student.git cd shafeea_student -
Install dependencies:
flutter pub get
-
Generate code (Injectable & BloC):
dart run build_runner build --delete-conflicting-outputs
-
Run the app:
flutter run
The app uses JSON configuration files for different environments:
config_dev.json: Development environment settings.config_prod.json: Production environment settings (API URL, etc.).
Ensure these files are present in the root directory before building for production.
Contributions are welcome! Please follow these steps:
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Emran Nasser - GitHub
Project Link: https://github.com/shafeea-platform/shafeea_student
Created with ❤️ by the Shafeea Development Team