Adhyan - AI-Powered EdTech Platform ๐
A modern, comprehensive EdTech platform connecting students, parents, teachers, and school administrators through AI-powered features and intuitive design.
โจ Features
๐ฑ Mobile App (Students & Parents)
For Students:
- ๐ฏ Smart Dashboard: Personalized learning hub with real-time stats
- ๐ Daily Practice: AI-powered questions with intelligent hints
- ๐ฎ Educational Games: Gamified learning across all subjects
- ๐ Performance Analytics: Detailed progress tracking with AI insights
- ๐ Career Guidance: Personalized career assessment and roadmap
- ๐
Smart Schedule: Interactive timetable with live class status
- ๐ Leaderboards: Competitive learning with achievements
For Parents:
- ๐จโ๐ฉโ๐งโ๐ฆ Multi-Child Management: Unified dashboard for all children
- ๐ Real-time Tracking: Live attendance and performance monitoring
- ๐ฐ Fee Management: Secure online payments and transaction history
- ๐ฌ Communication Hub: Direct messaging with teachers
- ๐ Behavior Insights: Comprehensive activity and behavior tracking
- ๐ค Meeting Scheduler: Easy parent-teacher appointment booking
๐ Web Portal (Teachers & Admins)
For Teachers:
- ๐ Lesson Planner: AI-assisted curriculum planning
- ๐ Smart Worksheets: Auto-generated practice materials
- โ
Assessment Tools: Intelligent test creation and grading
- ๐ฅ Class Management: Student progress tracking and analytics
For Administrators:
- ๐ซ School Management: Complete institutional oversight
- ๐ฉโ๐ซ Staff Management: Teacher onboarding and performance tracking
- ๐ Analytics Dashboard: School-wide performance insights
- โ๏ธ System Configuration: Platform customization and settings
๐๏ธ Architecture
Built with Clean Architecture principles and modern Flutter best practices:
lib/
โโโ core/ # Core utilities & configurations
โ โโโ constants/ # App-wide constants
โ โ โโโ app_colors.dart # Material Design 3 color palette
โ โ โโโ app_sizes.dart # Responsive sizing system
โ โ โโโ app_strings.dart # Internationalization-ready strings
โ โ โโโ app_images.dart # Asset path constants
โ โโโ theme/ # Theming system
โ โ โโโ app_theme.dart # Material Design 3 theme
โ โโโ widgets/ # Reusable UI components
โ โโโ custom_button.dart # Consistent button variants
โ โโโ custom_text_field.dart # Form input components
โ โโโ custom_card.dart # Card design system
โ โโโ skeleton_loader.dart # Loading state components
โโโ features/ # Feature-based modules
โ โโโ auth/ # Authentication & onboarding
โ โโโ student/ # Student-specific features
โ โโโ parent/ # Parent dashboard & tools
โ โโโ shared/ # Cross-feature components
โโโ main.dart # App entry point
โ โโโ loading_error_widgets.dart
โ
โโโ features/ # Feature modules
โ โโโ auth/ # Authentication
โ โ โโโ presentation/
โ โ โโโ pages/
โ โ โโโ splash_screen.dart
โ โ โโโ login_screen.dart
โ โโโ student/ # Student features
โ โ โโโ presentation/
โ โ โโโ pages/
โ โ โ โโโ student_dashboard.dart
โ โ โโโ widgets/
โ โ โโโ quick_stats_widget.dart
โ โ โโโ action_grid_widget.dart
โ โ โโโ today_schedule_widget.dart
โ โโโ parent/ # Parent features
โ โโโ presentation/
โ โโโ pages/
โ โโโ parent_dashboard.dart
โ
โโโ main.dart # App entry point
๐จ Design System
Color Palette
- Primary: Blue #2563EB (Trust, Intelligence)
- Secondary: Green #10B981 (Growth, Success)
- Accent: Orange #F59E0B (Energy, Attention)
- Semantic Colors: Success, Warning, Error, Info
Typography
- Font Family: Poppins (Google Fonts)
- Scales: Display, Headline, Title, Body, Label
Components
- Buttons: Elevated, Text, Outlined, Icon
- Cards: Standard, Gradient
- Input Fields: Custom styled with validation
- Loading States: Skeleton loaders, circular progress
๐ฆ Dependencies
Core Dependencies
flutter_riverpod: State management
google_fonts: Custom fonts
hive: Local database
dio: HTTP client
flutter_secure_storage: Secure data storage
UI Dependencies
fl_chart: Data visualization
syncfusion_flutter_charts: Advanced charts
shimmer: Skeleton loading
cached_network_image: Image caching
lottie: Animations
Firebase
firebase_core: Firebase initialization
firebase_analytics: Analytics
firebase_crashlytics: Crash reporting
firebase_messaging: Push notifications
๐ Getting Started
Prerequisites
- Flutter SDK (>=3.9.0)
- Dart SDK
- Android Studio / VS Code
- Firebase account (for backend services)
Installation
Clone the repository
git clone <repository-url>
cd adhyan
Install dependencies
flutter pub get
Run the app
flutter run
๐ง Development Guidelines
Best Practices Implemented
โ
Use constants for reusable values - All colors, sizes, and strings centralized
โ
Custom widgets for common UI - Buttons, text fields, cards
โ
Stateless widgets over functions - Better performance
โ
Minimal widget tree - Optimized rendering
โ
Const constructors - Improved performance
โ
Clean architecture - Separation of concerns
โ
Skeleton loading - Better UX during data fetch
โ
Update mechanism - Version checking and force updates
โ
Service status monitoring - Downtime detection
Code Quality
- Linting:
flutter_lints + very_good_analysis
- Type Safety: Strict null safety enabled
- Code Generation:
build_runner for models and providers
๐ฑ App Flow
Student Flow
Splash โ Login (Role: Student) โ Dashboard โ Features
โโโ Learn (Daily Practice, Tests, Resources)
โโโ Games (Educational Games, Leaderboard)
โโโ Profile (Settings, Performance)
Parent Flow
Splash โ Login (Role: Parent) โ Dashboard โ Child Selection
โโโ Attendance Tracking
โโโ Performance Reports
โโโ Fee Management
โโโ Communication
โโโ Behavior Tracking
๐ฏ Implementation Roadmap
Phase 1: Foundation (Current) โ
- Project setup and structure
- Core constants and theme
- Custom reusable widgets
- Authentication screens
- Student dashboard
- Parent dashboard
Phase 2: Learning Features
- Daily practice module
- Mock tests with timer
- AI-powered hints
- Subject-wise learning
- Progress tracking
Phase 3: Analytics & Games
- Performance dashboard
- Charts and visualizations
- Educational games lobby
- Leaderboard system
- Achievement system
Phase 4: Career & Resources
- Career assessment
- Career exploration
- Study materials
- Timetable and syllabus
- School directory
Phase 5: Advanced Features
- Offline-first architecture
- Update mechanism
- Biometric authentication
- Push notifications
- Real-time sync
Phase 6: Web Portal
- Super admin panel
- School admin panel
- Teacher dashboard
- Test portal for students
- AI worksheet maker
๐ Security Features
- Secure local storage with encryption
- Biometric authentication support
- Session timeout management
- Role-based access control
- Data validation and sanitization
๐ State Management
Using Riverpod for:
- Dependency injection
- State management
- Async data handling
- Provider composition
- Code generation support
๐จ UI/UX Highlights
- Material Design 3 principles
- Smooth animations and transitions
- Pull-to-refresh functionality
- Skeleton loading states
- Error handling with retry
- Offline mode indicators
- Dark mode support (future)
๐งช Testing
# Run tests
flutter test
# Run with coverage
flutter test --coverage
๐ฑ Build & Release
# Android APK
flutter build apk --release
# Android App Bundle
flutter build appbundle --release
# iOS
flutter build ios --release
๐ค Contributing
We welcome contributions! Here's how you can help:
Types of Contributions
- ๐ Bug Fixes: Report and fix issues
- โจ New Features: Add new functionality
- ๐ Documentation: Improve docs and guides
- ๐จ UI/UX: Enhance user experience
- ๐งช Testing: Add tests and improve coverage
- ๐ Translations: Add i18n support
Development Workflow
- Fork the repository
- Create feature branch
git checkout -b feature/amazing-feature
- Follow coding standards
- Use the established patterns
- Add tests for new features
- Update documentation
- Run
flutter analyze and fix warnings
- Commit with descriptive messages
git commit -m 'feat: add amazing new feature'
- Push and create PR
git push origin feature/amazing-feature
Code Style
- Follow Effective Dart guidelines
- Use
flutter_lints for code analysis
- Prefer
const constructors where possible
- Use descriptive variable and function names
- Add comments for complex logic
๐ Issues & Bug Reports
Found a bug? Please help us improve by reporting it:
- Search existing issues first
- Use issue templates when creating new issues
- Provide detailed reproduction steps
- Include screenshots/logs if applicable
- Specify platform and Flutter version
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Adhyan EdTech Platform
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
๐ Acknowledgments
- Flutter Team for the amazing framework
- Material Design for design guidelines
- Riverpod for excellent state management
- Firebase for backend services
- Open Source Community for inspiration and contributions
๐ Support & Contact
๐ Deployment
Environment Setup
Create .env files for different environments:
# .env.dev
API_BASE_URL=https://dev-api.adhyan.com
FIREBASE_PROJECT_ID=adhyan-dev
# .env.prod
API_BASE_URL=https://api.adhyan.com
FIREBASE_PROJECT_ID=adhyan-prod
CI/CD Pipeline
The project includes GitHub Actions workflows for:
- Code Quality: Linting, formatting, and analysis
- Testing: Unit and widget tests
- Building: APK/AAB generation for releases
- Deployment: Automated releases to app stores
๐ Analytics & Monitoring
- Firebase Analytics: User behavior tracking
- Crashlytics: Crash reporting and monitoring
- Performance Monitoring: App performance insights
๐ Version Management
We follow Semantic Versioning:
- MAJOR: Breaking changes
- MINOR: New features (backward compatible)
- PATCH: Bug fixes and improvements
๐ฏ Project Goals
- Accessibility: Make quality education accessible to all
- Innovation: Leverage AI to personalize learning
- Collaboration: Foster better communication between stakeholders
- Performance: Ensure smooth, fast user experience
- Scalability: Design for growth and expansion
๐ License
This project is proprietary and confidential.
๐ฅ Team
- Development Team: Building the future of education
- Design Team: Creating delightful experiences
- AI Team: Powering intelligent features
๐ Support
For support, email support@adhyan.com or raise an issue in the repository.
Made with โค๏ธ for education