Skip to content
KrishJdevPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Aven Fit ⚡

High-Performance, Offline-First Workout Tracker & Nutrition Engine
Engineered for speed, precision, and sharp glassmorphism clarity on Android.


Flutter Dart Spring Boot Java PostgreSQL SQLite License


🎯 Overview

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.


📚 Documentation & Architecture

  • 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.

✨ Key Features

🏋️‍♂️ 1. Workout & Routine Logging

  • 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.

⏱️ 2. Rest Timer & Background Notifications

  • Automatic Rest Timer: Triggers seamlessly upon logging a set with per-exercise interval memory.
  • Quick Controls: +30s, -30s, Skip, and instant background countdown alerts.

📊 3. Analytics & Personal Record (PR) Vault

  • Automatic PR Detection: Real-time celebration and ledger recording for MAX_WEIGHT, MAX_REPS, and EST_1RM (calculated via Brzycki formula).
  • Progress Tracking: Interactive historical progression charts, consistency streaks, and muscle volume analytics.

🍎 4. Indian Nutrition & Macro Engine

  • 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.

🔄 5. Offline-First Architecture & Cloud Sync

  • 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.

🛠️ Technology Stack

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

📁 Repository Structure

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)

🚀 Getting Started

Prerequisites

  • Flutter SDK: v3.24+
  • JDK: Java 21
  • Android Studio: Android SDK & Android 14/15 Virtual Device (Pixel 8 recommended)
  • PostgreSQL: v16+ (for backend development)

📱 Mobile Setup (Flutter)

  1. Navigate to the mobile directory:

    cd mobile
  2. Get dependencies:

    flutter pub get
  3. Configure local Android SDK path:
    Create mobile/android/local.properties (if not already present):

    sdk.dir=C\:\\Users\\<YourUsername>\\AppData\\Local\\Android\\Sdk
  4. Launch on Android Emulator / Device:

    flutter run

☕ Backend Setup (Spring Boot)

  1. Navigate to the backend directory:

    cd backend
  2. 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;
  3. Build and Run:

    ./gradlew bootRun

    Flyway will automatically execute database migrations upon startup.


🎨 Design Philosophy

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.

📄 License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages