Fitness & Wellness Kit
Expo SDK 58 + Hono full-stack mobile fitness template.
The OTF Fitness & Wellness Kit is a complete cross-platform fitness app starter. Expo SDK 58 + Hono backend + Postgres + Better Auth. The delivered kit does not include app-level payments. Live web demo at fitness-preview.otf-kit.dev.
Stack
| Layer | Choice |
|---|---|
| Framework | Expo SDK 58 + React 19 + Expo Router (iOS · Android · Web) |
| Routing | Expo Router (file-based) |
| Data | TanStack Query |
| Server | Hono 4 + Bun 1.3 |
| DB | Postgres + Drizzle ORM 1.0-rc |
| Auth | Better Auth 1.6 + @better-auth/expo — email + Google + bearer (native) + cookies (web) + demo login |
| UI | Plain RN + react-native-svg + kit-local primitives, with @otfdashkit/ui-native for shared blocks |
| Deploy | bash scripts/deploy-worker.sh deploys the static web demo to Cloudflare Workers (OTF's live demo runs this way); the Dockerfile serves the same demo on any container host. Neither starts the Hono backend. EAS Build is separate for native binaries; the deployment guide ships with the kit. |
Pre-built screens
The kit ships with 35 screens modelled after Apple Fitness:
- Auth: login, signup
- Onboarding: welcome, goal, height, weight, target weight, activity level, reminders and paywall
- Summary (LANDING): Activity Rings hero + 2x2 metric grid + recent workouts
- Ring detail: week strip + giant ring + intraday calorie bars
- Metric detail: D/W/M/Y SegmentedControl + 2 metric cards
- Workout: type chips + Start CTA + recent log
- Workout start: live timer + calorie/distance counters + End CTA
- Workout detail: completed-workout summary + delete
- Programs: program list and program detail (every exercise, with Start pinned at the bottom)
- Nutrition: macro breakdown, food search, food log, Scan food (photo or barcode) and food detail
- Progress: workout analytics, weight tracking and progress photos
- Notifications and connected devices
- Sharing (sub-screen of Profile): awards + friends activity feed
- Goal: StepperBig for daily move goal
- Profile (5th tab): avatar + all-time stats + dark and light switch + accent palettes + settings
The 5 bottom tabs: Summary · Workout · Nutrition · Programs · Profile.
Reusable blocks
| Block | Used for |
|---|---|
<ActivityRings /> | 3 concentric SVG rings (hero or week-strip mini) |
<WeekStrip /> | 7 mini rings + day-letter labels |
<StepperBig /> | Big number with ⊖/⊕ circular buttons (goal screens) |
<MetricCard /> | Label + big-number value + unit + optional trend |
<SegmentedControl /> | D/W/M/Y capsule with sliding active pill |
<MiniBarChart /> | Inline 7- or 24-bucket bar chart |
Database
- 5 Better-Auth tables:
user,account,session,jwks,verification - 9 app tables:
userPublic,dailyGoal,workoutType,workout,award,friendship,meal,progressPhoto,weightEntry
Demo + QR preview
fitness-preview.otf-kit.dev shows the kit running in a phone frame, with a QR to the OTF Kits app. Scan it on Android to install the app, then open the Fitness Kit inside it; on iPhone, use the live demo.
Native builds
Native iOS / Android binaries are produced via EAS Build:
eas build --profile preview --platform ios
eas build --profile preview --platform androidThe eas.json ships with development, preview, and production profiles. Submit to
TestFlight + Play Internal Testing via eas submit.
Web safe-area shim — important
app/_layout.tsx wraps the kit in <WebSafeAreaShim> — a SafeAreaInsetsContext.Provider
that injects top: 56 ONLY when iframed (the marketing preview at fitness-preview.otf-kit.dev
shows the kit inside a phone frame). On standalone web, this returns 0 so the kit reads
edge-to-edge. Don't add layout-level paddingTop — go through useSafeAreaInsets() instead.
Deploy
bash scripts/deploy-worker.sh deploys the static web demo to Cloudflare Workers; OTF's live demo
runs this way. The kit's Dockerfile serves the same demo on any container host (Fly, Render,
Railway or a VPS). Neither starts the Hono + Better Auth backend; run server/index.ts yourself.
Native iOS and Android binaries use EAS Build separately. The deployment guide ships with the kit.
Required env
| Variable | Purpose |
|---|---|
DATABASE_URL | Postgres connection string |
BETTER_AUTH_SECRET | 32+ chars — signs sessions/JWTs |
BETTER_AUTH_URL | Public origin |
EXPO_PUBLIC_API_URL | (native builds only) Public API URL the iOS/Android binary points at |
Optional: GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET. DEMO_LOGIN_DISABLED=1.
Buy
$99 on otf-kit.dev — or Everything Bundle ($149 = 6 delivered Live kits + all 20 landing templates; $774 separately, save $625.)