Attendrix revolutionises how students manage academics — seamlessly blending attendance tracking, personalised scheduling, study resources, and engaging gamification. Built on modern full-stack tech, it brings automation and clarity to daily academic life.
- Automatic Course Assignment: Attendrix intelligently assigns core courses based on your semester and branch
- Flexible Elective Selection: Choose electives that align with your academic goals and interests
- Institute Slot Integration: Seamlessly integrates with NIT Calicut's official slot system for accurate scheduling
- Custom Class Creation: Create personalized classes with custom slots and timings
- Institute Slot Support: Utilise existing NIT Calicut time slots for standardised scheduling
- Real-time Schedule Updates: Stay updated with any changes to your class schedule
- Assignment Management: Track current assignments with due dates and submission status
- Exam Notifications: Get notified about upcoming exams for your enrolled courses
- Grade Tracking: Record and monitor your marks for assignments and exams
- Personal Notes: Add custom notes and reminders to specific classes
- Flexible Timing: Set class notifications up to 2 hours before class starts
- Smart Cancellation Detection: AI-powered system detects class cancellations automatically
- User Feedback Integration: Report class cancellations to help improve the system's accuracy
- Honor Score Algorithm: Dynamic user-specific scoring based on reporting accuracy
- Multi-factor Analysis: Considers enrollment numbers, historical data, and user reliability
- Automated Decisions: Intelligent class cancellation without admin intervention
- Point Rewards: Earn points for attending classes and maintaining streaks
- Streak System: Build and maintain daily attendance streaks
- Weekly & Monthly Challenges: Unique, personalized challenges for every user
- Fair Rewards: Equal earning potential across all users despite different challenges
- Integrity Monitoring: Robust system to prevent attendance manipulation
- Progress Penalties: Users lose progress for marking attended classes as absent
- Fair Play Enforcement: Maintains the integrity of the gamification system
- Course-based Materials: Access study materials tailored to your enrolled courses
- Custom Organization: Create folders and organize your files efficiently
- Offline Access: Cached files available without internet connection
- Anywhere Access: Study materials available across all your devices
Get a complete overview of your academic progress at a glance
Organize your courses and access study materials seamlessly
Make attendance fun with our engaging reward system
Stay informed with intelligent, customizable notifications
📸 Screenshots are from the latest alpha build. UI may vary in the final release.
- Enable Unknown Sources: Go to Settings > Security > Enable "Install from Unknown Sources"
- Download the APK: Click the download button above or visit our Releases page
- Install: Open the downloaded APK file and follow the installation prompts
- Permissions: Grant necessary permissions for notifications, storage, and camera (for QR code scanning)
- Android 6.0 (API level 23) or higher
- 100 MB free storage space
- Internet connection for sync and real-time features
- Flutter SDK (latest stable version)
- Dart SDK
- Android Studio / VS Code with Flutter extensions
- Git
-
Clone the repository
git clone https://github.com/sh1shank/attendrix.git cd attendrix -
Switch to the FlutterFlow branch
git checkout flutterflow
-
Install dependencies
flutter pub get
-
Run the app
flutter run
- Update the configuration files with your specific NIT Calicut slot timings
- Configure notification preferences
- Set up your academic profile
mainbranch: Documentation, README, and project assetsflutterflowbranch: Complete Flutter/Dart source code
Attendrix is architected for speed, flexibility, and intelligent automation using a hybrid cloud + serverless model.
- Flutter + FlutterFlow: Cross-platform UI with custom Dart actions
- Client-Heavy Logic: Most features run offline with background sync
- Supabase (PostgreSQL) – Primary database for:
timetableRecords,attendanceRecords,amplixLogs- Enforced Row-Level Security (RLS) per user
- RPC Functions and Edge Functions for streaks, rollback, challenge updates, analytics
- Firestore (Selective Use) – Stores sensitive real-time metadata (e.g., Amplix scores, session info)
- Firebase Authentication – Handles secure login and session management
- Firebase Storage – Stores study materials and static files
- BuildShip:
- Automates Google Calendar sync, daily CRON jobs, API key management, and Amplix workflows
- Zapier:
- Parses attendance data from external tools
- Google Cloud APIs:
- Google Calendar API (Planned): Syncs class schedules with user calendars
- Google Drive API: Upload, fetch, and organise shared academic resources
- Gemini 2.0 Flash Lite with NotebookLLM via MCP servers for real-time LLM-based doubt resolution
- Bring Your Own LLM: User-supplied API keys (OpenAI, Claude, Gemini) for personalized AI support
- ✅ Android
- 🔄 iOS (Coming Soon)
- ✅ Web
We welcome contributions from the NIT Calicut community! Please read our Contributing Guidelines before submitting pull requests.
- Fork the repository
- Clone your fork and switch to the
flutterflowbranch - Create a feature branch from
flutterflow - Make your changes
- Test thoroughly
- Submit a pull request to the
flutterflowbranch
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- Flutter and FlutterFlow communities for excellent development tools
- All beta testers and contributors who helped shape Attendrix
For support, feature requests, or bug reports:
- 📧 Email: support@attendrix.site
- 🐛 Issues: GitHub Issues
- 💡 Have an idea? Suggest a feature!
- 💬 Discussions: GitHub Discussions
Attendrix is continuously evolving! Here's what's coming next:
Seamless integration of Gemini 2.0 Flash Lite API for real-time, conversational doubt solving—leveraging MCP servers and NotebookLLM to ensure fast, context-agnostic support that avoids reliance on course-specific material, enabling broader and more adaptive learning.
Allow users to link their own Google API Keys or other LLM providers (like OpenAI, Claude, or Gemini) to enable personalized assistant bots that access current syllabus documents, provide contextual answers, and clarify doubts with source-linked citations.
Full customizable theming system with support for:
- Dark, Light, and High-Contrast themes
- Accent color selection
- Theme presets tied to time-of-day or focus modes (e.g., "Study Mode")
Major update to the Amplix-powered challenge system with:
- Daily and surprise micro-challenges
- Leaderboards, trophies, and streak-based power-ups
- Integration with class participation and attendance data
Two-way sync with Google Calendar, allowing:
- Auto-import of classes, tests, and events
- Push reminders based on real-time class status and attendance
- Suggestions for missed classes and make-up sessions
Enable offline usage of key features like attendance logging and timetable viewing with an intelligent sync queue to push updates when back online.
Set custom goals such as 90% for a class and get notified if you are below it or if you will lose that goal if you don't attend the next class.
Detailed insights into your academic performance with predictive analytics.
Made with 💜 for NIT Calicut Students
Attendrix - Making attendance management intelligent, engaging, and effortless
