StatsHub documentation
Architecture, setup, and conventions for the StatsHub monorepo.
Choose the app or task you are working on.
Web
The Next.js 14 product site and its existing API routes.
Expo
The iOS and Android app.
API
The Go API replacing the web app's API routes.
Docs
This Fumadocs site and the generated API reference.
Local services
| Service | Command | Address |
|---|---|---|
| Web | pnpm dev | http://localhost:3000 |
| Docs | pnpm dev:docs | http://localhost:3001/docs |
| API | pnpm dev:api | http://localhost:8080/api/health |
| Expo | pnpm dev:expo | Metro on port 8142 |
This development box is remote. From another device, use the addresses from
node packages/statshub-tooling/apps.cjs, not localhost.
Repository map
apps/contains the web, API, Expo, and docs applications.packages/contains shared UI, transport, configuration, filters, i18n, and tooling.apps/web/src/pages/apiis the behavior reference for the Go port.apps/docs/content/docsis the only documentation source. Obsidian opens the same directory through a symlink.
Start with Getting started, then read Architecture and the relevant app section.