High-Performance, Offline-First Workout Tracker & Nutrition Engine
Engineered for speed, precision, and sharp glassmorphism clarity on Android.
Aven Fit is an athletic, technical, and distraction-free fitness tracking application designed to eliminate friction in the gym. Built with an offline-first architecture and high-contrast editorial aesthetics, Aven Fit ensures that logging a set takes less than 3 seconds, even without internet connectivity.
-
ARCHITECTURE.md— Feature-First Clean Architecture blueprint, layer contracts, data flow diagrams & implementation templates. -
FEATURES.md— Detailed feature specifications, screen layouts, and Phase build priorities ([P0]$\rightarrow$ [P1]$\rightarrow$ [V1.1]). -
AGENTS.md— Multi-agent collaboration protocol, 10 Stack Laws, and coding guardrails. -
HANDOFF.md— Active session memory, vertical slice milestones, and real-time sprint state.
- Ultra-Fast Set Logging (<3s): 1-tap logging with previous workout history pre-fill (
PREV), weight, reps, RPE, and set classifications (WARMUP,NORMAL,DROP,FAILURE). - Custom Routine Builder: Create, organize, and re-order workout routines with pre-configured targets and rest intervals.
- 200+ Exercise Library: Comprehensive directory of compound and isolation movements tagged by primary and secondary muscle groups.
- Custom Exercises: Add bespoke movements with equipment and muscle group assignments.
- Automatic Rest Timer: Triggers seamlessly upon logging a set with per-exercise interval memory.
- Quick Controls:
+30s,-30s,Skip, and instant background countdown alerts.
- Automatic PR Detection: Real-time celebration and ledger recording for
MAX_WEIGHT,MAX_REPS, andEST_1RM(calculated via Brzycki formula). - Progress Tracking: Interactive historical progression charts, consistency streaks, and muscle volume analytics.
- Curated Food Database: Tailored specifically for Indian dietary habits (Roti, Dal, Paneer Tikka, Chicken Curry, Oats, Rice, etc.) alongside international staples.
- Regional Serving Units: Track intake accurately using standard units (
katori,roti,scoop,grams,bowl). - High-Density Macro Ledgers: Real-time tracking of calories, protein, carbohydrates, and fats.
- Local-First Speed: Instant local reads and writes powered by high-performance SQLite.
- Background Sync Engine: Automatic change queueing (
sync_queue) with conflict resolution and bi-directional server synchronization when connectivity is restored.
| Layer | Technology | Description |
|---|---|---|
| Mobile Client | Flutter + Dart | High-performance Android application with Sharp Glassmorphism UI |
| State Management | Riverpod 2.x | Notifiers/Stores with unidirectional state and dependency injection |
| Navigation | GoRouter | Declarative routing with deep links and shell routes |
| Local Database | SQLite via Drift (drift_flutter + sqlite3_flutter_libs) |
Reactive, compile-safe queries for offline-first persistence |
| Networking | Dio | Typed HTTP client for the Spring Boot API |
| Domain Models | Freezed + JsonSerializable | Immutable models with JSON codegen |
| Backend API | Spring Boot 3.3 + Java 21 | Modular REST architecture with clean domain separation |
| Security & Auth | Spring Security + JWT | Phone OTP and OAuth token rotation |
| Server Database | PostgreSQL 16 + Flyway | Scalable relational storage with version-controlled migrations |
aven-fit/
├── mobile/ # Flutter Android application
│ ├── android/ # Native Android project files
│ ├── lib/
│ │ ├── core/ # Shared primitives (feature-agnostic)
│ │ │ ├── database/ # Drift database, tables, DAOs & migrations
│ │ │ ├── network/ # Dio client, interceptors & API endpoints
│ │ │ ├── router/ # GoRouter configuration (deep links, shell routes)
│ │ │ └── theme/ # Sharp Glassmorphism design system, typography & palette
│ │ ├── features/ # Feature-first vertical slices
│ │ │ ├── workout/ # Active session, set logging, rest timer
│ │ │ │ ├── domain/ # Freezed immutable models
│ │ │ │ ├── data/ # Drift DAOs, data sources & repository impl
│ │ │ │ └── presentation/# Riverpod notifiers/stores + ConsumerWidget UI
│ │ │ ├── routine/ # Routine builder, templates & scheduling
│ │ │ ├── exercise/ # Directory, detail & custom exercises
│ │ │ ├── nutrition/ # Indian food DB, meal logging & macros
│ │ │ ├── progress/ # PR vault, analytics & body metrics
│ │ │ └── auth/ # OTP login, guest mode & sync identity
│ │ └── main.dart # Application entry & initialization
│ │
└── backend/ # Spring Boot application
├── src/main/java/com/avenfit/
│ ├── auth/ # Security, JWT & OTP services
│ ├── exercise/ # Exercise & muscle group domain
│ ├── workout/ # Live workout & set logging services
│ ├── routine/ # Routine templates & sets
│ ├── nutrition/ # Food items & meal logging
│ ├── analytics/ # PR tracking & volume summaries
│ └── sync/ # Push/pull synchronization controllers
└── src/main/resources/
└── db/migration/ # Flyway schema migrations (V1–V10)
- Flutter SDK:
v3.24+ - JDK:
Java 21 - Android Studio: Android SDK & Android 14/15 Virtual Device (Pixel 8 recommended)
- PostgreSQL:
v16+(for backend development)
-
Navigate to the mobile directory:
cd mobile -
Get dependencies:
flutter pub get
-
Configure local Android SDK path:
Createmobile/android/local.properties(if not already present):sdk.dir=C\:\\Users\\<YourUsername>\\AppData\\Local\\Android\\Sdk -
Launch on Android Emulator / Device:
flutter run
-
Navigate to the backend directory:
cd backend -
Setup PostgreSQL Database:
CREATE USER avenfit WITH PASSWORD 'avenfit_dev_password'; CREATE DATABASE avenfit_dev OWNER avenfit; GRANT ALL PRIVILEGES ON DATABASE avenfit_dev TO avenfit;
-
Build and Run:
./gradlew bootRun
Flyway will automatically execute database migrations upon startup.
Aven Fit adheres to a Sharp Glassmorphism design language:
- OLED Surface & Translucency: Pitch-black background with translucent glass cards and crisp, precise edges.
- High-Contrast Palette: Neon Cyan (
#00F0FF) primary accent, Volt Green (#E2F835) for PRs/deltas, and Burnt Orange (#E85D04) for warnings/destructive actions. - Dense, Technical Typography: Monospaced tabular numerical alignment for effortless set scanning.
This project is licensed under the MIT License.