FitOS Local

FitOS Local is a local-first personal fitness OS for cycling, golf, posture-focused strength routines, InBody tracking, supplements, calendar planning, and AI-assisted routine generation.

The project targets a dark, data-rich React dashboard experience guided by the documents in Instruction/.

Product Direction

• Local browser data first, with IndexedDB persistence.
• Daily cycling, golf, upper-body strength, posture correction, supplements, and InBody signals in one workflow.
• Gym availability based on Tsukuba University Central Gym rules and Japanese public holidays.
• Routine design biased toward rounded-shoulder correction, thoracic mobility, scapular stability, back strength, and golf core stability.
• No lower-body weight training in the default routines.

Current App

The implemented app includes:

• Vite + React single-page app.
• Responsive dark glass dashboard matching the frontend design specification.
• IndexedDB persistence with localStorage fallback.
• Today dashboard with gym availability, calorie split, weekly consistency, routine preview, supplement checklist, and quick inputs.
• Calendar with Japanese holiday-aware gym hours, workout/activity badges, and a day detail drawer.
• Daily log form for cycling, golf, weights, supplements, notes, and calorie calculations.
• Routine editor for the default posture/golf/core-focused weekly plan.
• AI routine prompt builder with a safe preview/apply flow.
• InBody trend page with CSV upload and report-style body composition panels.
• Supplement library and daily intake tracking.
• Settings for weight, calorie target, LLM provider, gym overrides, and JSON backup export.

Samsung Health

Samsung Health integration is prepared through a future Android Health Connect bridge. The app now has sync settings and a normalized healthDaily data shape for sleep, heart rate, steps, activity, calories, distance, and exercise sessions. See docs/samsung-health-integration.md.

InBody CSV Data

New InBody exports should be placed in inbodydata/ with the same header format as InBody-20260503.csv.

cd frontend
npm run import:inbody

The import command generates frontend/src/data/inbody.generated.js, which is loaded into the default state and merged into existing IndexedDB data. The InBody page also accepts CSV uploads directly in the browser.

Resistance Training Basis

Default routines are now aligned to the 2026 ACSM Position Stand, Resistance Training Prescription for Muscle Function, Hypertrophy, and Physical Performance in Healthy Adults: An Overview of Reviews.

The app translates the paper into a practical upper-body program:

• high-effort resistance training at least twice per week;
• heavier strength work near the start of the session, using full range of motion;
• sufficient weekly hypertrophy volume for priority muscle groups;
• short moderate-load power blocks with fast concentric intent for golf rotation and function;
• no routine requirement to train to momentary failure;
• lower-body weight training remains excluded because cycling is treated as the lower-body aerobic stimulus.

Run Locally

cd frontend
npm install
npm run dev

Development URL: http://localhost:5174

Production build:

cd frontend
npm run build

Repository Phases

• Phase 0: Repository foundation and design/project baseline.
• Phase 1: React app shell, tooling, design tokens, responsive navigation.
• Phase 2: Local data model, gym/calorie logic, dashboard, calendar, daily log.
• Phase 3: Routines, AI routine preview, InBody, supplements, settings, polish.
• Phase 4: Verification, documentation, GitHub repository publishing.

GitHub Description

Local-first React fitness OS for cycling, golf, posture-focused strength routines, InBody tracking, supplements, calendar planning, and AI-assisted workout generation.