Fitme

The monorepo behind Fitme, an AI workout planner and tracker: the iOS app, Arnold (Fitme's AI), the backend services and the web apps, on pnpm and Turborepo.

Users sign in with Clerk. Data lives in Supabase Postgres, reached by the Node apps through @fitme/db and by the clients with their Clerk session token (row-level security reads the Clerk id); there is no Supabase Auth and there are no Supabase Edge Functions.

Layout

Workspace	Package	What it is
apps/mobile	@fitme/mobile	Expo / React Native app (expo-router, uniwind, RevenueCat, Sentry)
apps/arnold	@fitme/arnold	Arnold, Fitme's AI: an EVE agent, models through Vercel AI Gateway
apps/api	@fitme/api	Hono REST API (client config, Arnold model list)
apps/library	@fitme/library	Library API: Hono + zod-openapi over a baked-in library.json
apps/mcp	@fitme/mcp	MCP server (Streamable HTTP, Clerk OAuth) for ChatGPT and other MCP clients
apps/webhooks	@fitme/webhooks	Hono app receiving third-party webhooks (Clerk account deletion)
apps/web	@fitme/web	Next.js web app (account area)
apps/site	@fitme/site	Next.js marketing site
packages/core	@fitme/core	Domain models, labels, formatters, pure helpers
packages/library-sdk	@fitme/library-sdk	Library API client and its in-memory fake
packages/design-tokens	@fitme/design-tokens	Design tokens and text styles, one Tailwind v4 CSS file
packages/supabase	@fitme/supabase	Supabase project (migrations, pgTAP tests) and generated DB types
packages/db	@fitme/db	asUser / withService: the only way backend apps reach Postgres
packages/observability	@fitme/observability	Errors and traces (Sentry) with shared privacy rules
packages/rate-limit	@fitme/rate-limit	Per-caller rate limiter (Upstash Redis or in memory, fail open)
packages/services	@fitme/services	Business logic run inside an asUser / withService transaction
packages/typescript-config		Shared tsconfig presets

AGENTS.md is the detailed reference: architecture, patterns, every environment variable and CI/CD. Decisions are in docs/adr/, domain terms in GLOSSARY.md.

Running it locally

Needs Node 24, pnpm and Docker (for the local Supabase stack).

pnpm install

pnpm db start            # local Supabase stack

pnpm dev:mobile          # expo start
pnpm ios                 # expo run:ios (also: pnpm android)
pnpm dev:web             # :3000
pnpm dev:site            # :3001
pnpm dev:mcp             # :3002
pnpm dev:api             # :3003
pnpm dev:webhooks        # :3004
pnpm dev:arnold          # :3005
pnpm dev:library         # :3006, serving the made-up fixture library

Each app has an .env.example. Copy it to .env for apps/mobile and apps/library, or to .env.local for apps/web, apps/site and apps/arnold; apps/api, apps/mcp and apps/webhooks read the process environment instead. AGENTS.md lists what each variable does.

Checks

pnpm test                # unit tests in every workspace
pnpm typecheck
pnpm check               # Ultracite (Biome); pnpm fix applies its fixes
pnpm literal-check       # no color literals or arbitrary sizes in the UI

Contributing and security

This project doesn't take outside contributions; see CONTRIBUTING.md. Report vulnerabilities privately as described in SECURITY.md.