Android 8 or newer, ARM64 devices. Download the APK on your phone, open it, and allow installation from your browser when Android asks. Install future versions over the existing app to keep your data. See release notes.
OpenFit reads Apple Health on iPhone and Health Connect on Android. Clerk manages email and optional Google sign-in. Health permission is separate from the account. The Google Health cloud integration and the Apple Health export are retired.
The dashboard has configurable activity rings, metric cards and home-screen widgets. The exercise catalog and gym log work locally. Settings exports available device health, gym logs and goals as Markdown with a ready-made AI prompt. The web app supports accounts, training and local gym-log exports, but cannot read phone health records.
Use Bun and the Expo SDK 56 versioned documentation. Reuse an existing project server before starting another.
bun install
bun run start
bun run android
bun run iosNative health modules need a development or release build. Expo Go and a JavaScript-only update cannot install them.
The app uses EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY and EXPO_PUBLIC_API_BASE_URL. Server routes use CLERK_SECRET_KEY, HEALTH_AGENT_URL, and HEALTH_AGENT_CLERK_API_TOKEN. Keep secrets in local environment files and the hosting provider. Legacy Google client secrets are unused.
bun run lint
bunx tsc --noEmit
bun run test
bun run --cwd workers/health-agent check
bunx expo export --platform webThese checks do not establish physical-device permission or real-record behavior. Test both native platforms before a store release.
Android supports up to 30 days. Widgets refresh while OpenFit is in the foreground and, when the user grants Health Connect background read, every 30 minutes from the widget task handler. Summed widget metrics reset to -- after local midnight until the next read. iPhone also supports 90 days. Missing health records remain empty. The app does not write to either health store. Workouts recorded by other apps appear read-only under Workouts > History.
The built-in coach has been removed. Markdown exports are created locally and include 30 days of available device health, all gym logs saved on the device, daily goals and a prompt. Users choose where to share the file. Account credentials and Strava/Garmin connections are excluded. Strava and Garmin remain connection-only and require the existing provider approval flags.
See device health migration for privacy behavior, retired-token cleanup, Google verification cleanup and release requirements. Existing Google-linked accounts retain their previous server storage identifier. Email-only accounts use the Clerk user identifier.
The web app uses Expo Hosting. Export first, then deploy to the existing project.
bunx eas-cli deploy --prod --non-interactive --environment productionThe health agent uses the personal Cloudflare account pinned in its Wrangler config. Reports publish through /Volumes/T6-7/Coding/Personal/Reports.
Open Workouts → Schedules → New schedule and paste a schedule or select a JPEG, PNG, WebP, or PDF up to 8 MB. Choose the output language, then select Import schedule. Sign-in is required for analysis. Imports save automatically on this device. Each plan has reusable workout days, and Build manually lets you create a template without AI. Edit schedule changes prescriptions, adds days and exercises, or removes entries. The previous single saved schedule migrates into this library.
Log workout opens immediately for matched strength exercises, prefills fixed sets and reps, and carries the trainer's prescription and rest instructions into notes. Review the actual weight and reps before saving a completed workout. Cardio, mobility, and stretching stay in day order as instructions. Reimport an older plan to apply the improved PDF extraction and matching.
The server uses OPENROUTER_API_KEY, openai/gpt-6-luna for reading and translation, and typesafe/jev-1.14 through OpenRouter's Decisions API for catalog matching. The matcher is pinned to a version so the thresholds below keep their meaning; the server logs the model OpenRouter actually served and warns when it differs. Keep the key in .env.local and the Expo project's sensitive production environment. Never use an EXPO_PUBLIC_ key variable. The configured OpenFit key has a $5 total cap.
Extraction keeps original names, translated names, days, muscle columns, prescriptions, and shared rest instructions. Unique catalog names and aliases match locally. JEV handles remaining strength entries with the full exercise catalog and a no-match option, in parallel requests of up to 25 entries. Failed provider calls (500, 502, 503, 529 or network errors) are retried once. Matches below 0.8 choice probability require manual selection, and the top three alternatives become one-tap suggestions. These are conservative starting thresholds, not calibrated accuracy guarantees. Up to 60 entries per plan and 100 saved plans are supported. New native builds are required for expo-document-picker.
Run bun test src/lib/workout-schedule.test.js for regression checks. bun scripts/verify-workout-import.js [path-to-png-or-pdf] makes paid provider calls using a synthetic Italian schedule and expects bench press, lat pulldown, and back squat in that order.