A high-performance, clinical-grade medical syllabus tracker, habit anchor, and cognitive focus companion engineered for medical doctors and students preparing for NEET-PG, INI-CET, and USMLE.
π₯ Download Universal APK (v1.39.0) Β β’Β π Official Web Portal Β β’Β π Release Notes Β β’Β π Ecosystem Architecture
Modulix is architected as an offline-first distributed ecosystem combining an ultra-low-latency Flutter client, a responsive Cloudflare Pages edge portal, and an asynchronous Supabase synchronization engine.
graph TD
subgraph Client ["Client Ecosystem"]
A["π± Android Universal Client (Phones & Tablets)<br/>β’ Flutter 3.47+ / Riverpod 2.5<br/>β’ Hardware-Accelerated 180ms Slide Routing<br/>β’ 1Hz Focus Timer Heartbeat Engine<br/>β’ Bounded SQLite C-Engine (< 1MB initial)"]
B["π Cloudflare Pages Web Portal (modulix.pages.dev)<br/>β’ React 18 + Vite + Tailwind CSS<br/>β’ Edge CDN APK Distribution<br/>β’ Account & Data Erasure Compliance Hub"]
end
subgraph Backend ["Cloud Infrastructure"]
C["β‘ Supabase PostgreSQL Backend<br/>β’ Row-Level Security (RLS)<br/>β’ GoTrue JWT Authentication<br/>β’ Realtime WebSocket Event Stream<br/>β’ Single-Active-Device Lease Lock"]
end
subgraph Distribution ["Distribution & Security"]
D["π¦ Production Release Channel<br/>β’ Multi-ABI Universal Packaging (arm64/v7a/x86_64)<br/>β’ Permanent Upload Keystore (APK Signature v2/v3)<br/>β’ R8 ProGuard Obfuscation & Desugaring"]
end
A <-->|"Durable Outbox Queue (Offline-First TLS 1.3)"| C
B <-->|"Direct Auth & GDPR Data Purge"| C
D -->|"Continuous Delivery (tool/release.sh)"| A
D -->|"Edge Deployment"| B
- Replaced sluggish
OpenContainertransforms (380ms) with GPU-accelerated horizontal slide transitions (180ms forward, 150ms reverse) powered byCurves.easeOutCubic. - Wrapped navigation layers in isolated
RepaintBoundarypasses, delivering silky-smooth navigation across both 60Hz and 120Hz high-refresh displays.
- Built for multi-hour medical student marathons: throttled background ticker frequency from 5Hz down to 1Hz with immediate 0ms first-frame tick.
- Slashed idle CPU wakeups by over 80% and isolated the navigation dock halo pulsing ring with a
RepaintBoundaryto prevent raster cascades. - Built-in Pomodoro, count-up stopwatch, and module-linked study modes.
- Synthesized multi-track ambient soundscapes (forest rain, brown noise, crackling fireplace, deep stream).
- Persistent mini-timer overlay allowing seamless multi-tasking across curriculum pages.
- Immutable, tamper-proof
TimeLogrecording.
- Offline-First: All syllabus progress, study sessions, and tasks live in a sandboxed local SQLite database executed via direct C-engine bindings (
sqflite). - Memory Hardening: Slashed pre-allocated SQLite cache from 64MB down to 2MB (
PRAGMA cache_size = -2000). - Automated Compaction: Automatically runs
PRAGMA wal_autocheckpoint = 100, incremental auto-vacuum, startup WAL truncation, and purges orphaned legacy migration databases to prevent storage bloat.
- Completely eliminated synthetic test histories, mock streaks, fake syllabus velocities, and sample tasks.
- Newly downloaded fresh installs present clean, honest, zero-state interfaces ready for the student's authentic study journey.
- Complete syllabus mapping across Edition 8 (1,558 videos) and Edition 6.5 (1,593 videos).
- Multi-modal progress tracking across Videos, Q-Banks (MCQs), and High-Yield Clinical Notes.
- Instant search across all modules, unit numbers, titles, and clinical topics.
- Virtualized 120 FPS timeline with single-tap completion, elastic swipe-to-complete, and bulk unit marking.
- Smart daily task scheduling adhering to the 5:00 AM clinical rollover algorithm.
- Automated study plan quota engine: "2 Stale + 2 Fresh = 4" to prevent cognitive overload.
- Task status indicators (
[VID],[MCQ],[REV]) with instant completion toggling. - Organize tasks into dedicated projects, subtasks, priorities, and clinical tags.
- Interactive procedural blob companion rendered via custom math-driven fluid physics engine (
NoriBlobPainter). - State machine responding to study milestones, focus sessions, and streak achievements.
- Non-intrusive, zero-distraction clinical motivation.
- Single-Active-Device Lock: Each account is bound to one active client lease via
single_active_device, mathematically eliminating multi-device write collisions and resurrection traps. - Durable Outbox & Dead Letter Queue (DLQ): Poison-pill mutations transition to
'failed'after 5 retries to prevent endless retry loops. - Strict Data Sovereignty: Local JSON backup export/import, one-tap local device wipe, and cloud GDPR two-step account erasure portal.
- Queries the GitHub Releases API with 24-hour throttling.
- Strict Zero In-App Downloads Policy: Modulix never downloads or installs APKs internally. Update notifications present release notes and securely redirect users to the official Cloudflare web portal (
https://modulix.pages.dev) in their system browser.
Modulix is distributed as a single universal Android binary containing native shared libraries for all modern Android architectures:
| Specification | Target Configuration |
|---|---|
| Package Identifier | com.modulix.app |
| Version / Build | v1.39.0 (Build 144 / CKPT-144) |
| Supported ABIs | arm64-v8a (Modern 64-bit ARM), armeabi-v7a (32-bit ARM), x86_64 (Tablets / Emulators) |
| Minimum SDK | Android 7.0 (API Level 24) |
| Target SDK | Android 16 (API Level 36) |
| Signing Standard | APK Signature Scheme v2 & v3 (Upload Keystore RSA 2048-bit, PKCS12) |
| Code Shrinker | ProGuard / R8 with full optimization and desugaring |
Verify the APK signature with apksigner:
apksigner verify --verbose --print-certs modulix-v1.39.0.apk| Component | Filesystem Path | Repository / Remote | Production Target |
|---|---|---|---|
| Flutter Mobile Client | /home/safi/Downloads/antigravity/flowmd_flutter |
https://github.com/RxREAPER/Modulix.git (main) |
Android Universal APK (com.modulix.app) |
| Web Portal & Landing | flowmd_flutter/modulix_landing_page |
Monorepo (modulix_landing_page) |
Cloudflare Pages (modulix.pages.dev) |
| Supabase Migrations | flowmd_flutter/supabase/migrations |
Managed via Supabase CLI | vbvmzjhzznxgofyzxnql.supabase.co |
| Legacy Web App (PWA) | /home/safi/SAFI/FlowMD_web |
https://github.com/RxREAPER/FlowMD.git |
Firebase Hosting (flowmd-04.web.app) |
Releases are compiled, verified, tagged, and published via an automated single-command orchestrator:
./tool/release.sh <version> "<summary>" [--dry-run] [--skip-tests]- Pre-flight Quality Gate: Runs
flutter analyze --no-fatal-infosandflutter test. - Version Synchronization: Updates
lib/config/app_metadata.dartandmodulix_landing_page/src/lib/constants.ts. - Production Compilation: Compiles signed universal APK (
flutter build apk --release). - Signature Verification: Verifies binary integrity using
apksigner. - GitHub Release Publishing: Uploads signed APK to
RxREAPER/Modulixreleases with release notes. - Cloudflare Deployment: Builds Vite web app and deploys to
https://modulix.pages.dev. - Git & Checkpoint Tracking: Commits
checkpoint(release): ...and pushes toorigin/main.
- Flutter SDK (
>= 3.24.0, recommended3.47.4+) - Dart SDK (
>= 3.5.0, recommended3.13.0+) - Android Studio with Android SDK API 34+ (for Android builds)
- Java Development Kit (JDK 17 or JDK 21)
-
Clone the repository:
git clone https://github.com/RxREAPER/Modulix.git cd Modulix -
Install project dependencies:
flutter pub get
-
Verify static analysis:
flutter analyze --no-fatal-infos
-
Run the automated test suite:
flutter test -
Launch on connected device or emulator:
flutter run
Modulix/
βββ .github/ # CI/CD Workflows, PR & Issue Templates
β βββ workflows/ # GitHub Actions (CI, APK build, Pages deploy)
β βββ ISSUE_TEMPLATE/ # Bug Report & Feature Request templates
βββ android/ # Android native configuration & Kotlin MainActivity
β βββ app/ # build.gradle.kts, proguard-rules.pro, upload keystore
β βββ gradle.properties # JVM heap tuning (2GB for R8 compilation)
βββ assets/ # High-resolution audio, icons, illustrations, animations
βββ curriculum_data/ # NEET-PG / MBBS comprehensive syllabus datasets (Editions 6.5 & 8)
β βββ scripts/ # Data verification and compilation tools
β βββ raw/ # Canonical syllabus JSON definitions
βββ docs/ # Authoritative technical architecture & specifications
β βββ ECOSYSTEM.md # Master System Bible & Engineering Ledger
β βββ ARCHITECTURE.md # State management, routing, and persistence rules
β βββ BUILD_CHECKPOINTS.md # Incremental build and verification checkpoints
β βββ features/ # Feature design specs (timer, desk, streaks, tasks)
βββ lib/
β βββ config/ # AppMetadata (single source of truth), routes, constants
β βββ data/ # Compiled syllabus metadata & questions
β βββ models/ # Clinical syllabus, task, project, and timer domain models
β βββ providers/ # Riverpod state notifiers and providers
β βββ screens/ # UI Screens (Curriculum, Desk, Analytics, Timer, Settings, Tasks)
β βββ services/ # SQLite DatabaseService, SyncService, UpdateService, AudioService
β βββ theme/ # Clinical parchment & dark theme definitions
β βββ widgets/ # Reusable widgets (ApplePressable, LovableNavBar, NoriBlob)
βββ modulix_landing_page/ # Official Web Portal (React 18 + Vite + Cloudflare Pages)
βββ supabase/ # Supabase PostgreSQL migrations and edge configuration
βββ test/ # Unit, stress, and widget regression test suites (387+ tests)
βββ tool/ # Release orchestrator (release.sh)
βββ CHANGELOG.md # Semantic release history and milestone documentation
βββ CONTRIBUTING.md # Guidelines for contributing to Modulix
βββ LICENSE # MIT License
βββ pubspec.yaml # Dependencies and Flutter project configuration
For detailed architectural rationale, design decisions, and math algorithms, explore the docs/ directory:
- π Ecosystem Architecture Bible: Topology, database governance, sync protocols, and lifecycle invariants.
- ποΈ System Architecture: Riverpod patterns, partition models, and routing rules.
- β±οΈ Focus Timer Specification: Timer modes, tick engine, and
TimeLogformat. - π Daily Desk & Rollover: 5:00 AM rollover mathematics and task mutators.
- π Curriculum & Virtualization: Multi-modal syllabus and analytics-safe bulk marking.
- π Analytics & Streaks: Streak algorithms and distribution calculations.
- π·οΈ Build Checkpoint Manifest: Incremental checkpoint log and verification status.
This project is licensed under the MIT License β see the LICENSE file for details.
Medical Disclaimer: Modulix is an educational study companion designed to aid medical licensure preparation. It does not provide medical advice, diagnosis, or clinical treatment recommendations.