A production-scale academic platform used daily by 2000+ students, built under real-world constraints.
Alcademy is a client-orchestrated academic ecosystem designed for:
- Fragmented institutional systems
- Unreliable data sources
- Strict API rate limits
Instead of centralizing everything, responsibilities are distributed across systems, with the Flutter client acting as the orchestration layer.
| Area | What Makes It Different |
|---|---|
| Architecture | Client-driven orchestration (non-traditional) |
| Reliability | Works even when some sources fail |
| Performance | Heavy use of caching + isolates |
| Scalability | No single system bottleneck |
| Real-world usage | 2000+ active users |
┌──────────────────────────┐
│ External Systems │
│──────────────────────────│
│ • Google Gemini API │
│ • GitHub API (Notes) │
│ • College Websites │
│ (Scraped Data) │
└──────────┬───────────────┘
│
▼
┌──────────────────────────┐
│ Flutter Client │
│──────────────────────────│
│ • Feature Modules │
│ • API Orchestration │
│ • Caching Layer │
│ • Rate Limiting │
│ • Deep Linking │
│ • Isolates (Parsing) │
└───────┬────────┬─────────┘
│ │
┌────────────────┘ └────────────────┐
▼ ▼
┌──────────────────────┐ ┌────────────────────────┐
│ Supabase │ │ Firebase │
│──────────────────────│ │────────────────────────│
│ • Users │ │ • Push Notifications │
│ • Posts (Threads) │ │ (FCM only) │
│ • Clubs Data │ └────────────────────────┘
│ • Storage (Buckets) │
└──────────────────────┘
▼
┌──────────────────────────────┐
│ Local Device Layer 🔐 │
│──────────────────────────────│
│ • Secure Vault (Biometric) │
│ • Cached API Responses │
│ • Offline Utilities │
└──────────────────────────────┘
- Decoupled systems → failure in one source doesn’t break the app
- Client-side intelligence → reduces backend complexity
- GitHub as CDN → predictable scaling
- Local-first design → fast UX + offline support
🧠 “Move complexity to where it scales best — in this case, the client.”
Google Drive → Python Script → GitHub → Flutter App
| Step | Purpose |
|---|---|
| Google Drive | Easy content management |
| Python Script | Structured transformation |
| GitHub | CDN layer |
| Flutter | Smart consumption |
- GitHub-backed structured content
- Locally cached
- High-read optimized
- Supabase-powered discussions
- Deep linking enabled
- Club-managed communities
- Firebase FCM (delivery only)
- Event-triggered
- Gemini API integration
- Stateless architecture
- Low latency
- Web scraping pipeline
- Parsed via isolates
- Fault-tolerant
- Biometric-protected
- Local-only storage
- No backend dependency
- Smart API caching
- Rate limiting (60/hr + controlled refresh)
- Background parsing (isolates)
- Lazy loading
- 41 min avg engagement
- Smooth UI under heavy load
- Reduced API failures
| Layer | Strategy |
|---|---|
| 🌐 GitHub | Static scaling |
| 🧩 Supabase | Relational scaling |
| 🧠 Client | Orchestration |
No single system becomes a bottleneck.
- Resilient multi-source system
- Reduced backend dependency
- Designed for unreliable environments
- High engagement via performance tuning
- Client-side system design
- API orchestration
- Flutter performance patterns
- Caching + rate limiting
- Building under constraints
| Layer | Tech |
|---|---|
| Mobile | Flutter (Dart) |
| Backend | Supabase |
| Notifications | Firebase FCM |
| Content | GitHub API |
| AI | Google Gemini API |
| Local | SharedPreferences + Biometrics |
| Decision | Reason |
|---|---|
| Client-heavy logic | Reduced backend complexity |
| GitHub as CDN | Free + scalable |
| Stateless AI | Faster responses |
| Scraping notices | No official APIs |
- Fast (offline-first + caching)
- Smart (AI + orchestration)
- Secure (biometric vault)
- Resilient (multi-source fallback)
git clone https://github.com/your-repo
cd your-repo
flutter pub get
flutter runCurrently not open for external contributions.
Alcademy is a system design project disguised as a mobile app.
Built with one goal:
🪐 Deliver fast, reliable academic access even in imperfect environments.