StatsHub documentation
Everything documented about StatsHub — the monorepo, the API, the mobile app, and the guides for adding to any of them.
StatsHub is a Turborepo workspace on Bun: seven apps, four shared packages, one Postgres database, and a Go API that is being ported route-for-route from a Next.js one. This site documents all of it.
Every doc in the repo is a file under apps/statshub-docs/content/docs. There is no
docs/ at the repository root and none inside an app — if you find one, it is a
leftover, and it belongs here.
Start here
Getting started
Install once, bring up every dev server, and know which gate to run before you push.
Architecture
What each app owns, why there are two UI kits, and how a change reaches production.
The codebase
Apps
web, admin, api, docs, expo, legacy, and the one Flask tool.
Packages
Two UI kits, the Drizzle schema, and the contract that proves the Go port faithful.
Mobile app
Screens, data, errors and conventions in the Expo app.
Guides
Add a docs page, an app, a package, a UI component.
Agents
What a coding agent reads here, and which skill to load for which task.
The API
Endpoint reference
All 293 documented operations, generated from the Go handlers that serve them.
OpenAPI and /api/v2
How the described surface is recovered, and what it deliberately leaves open.
Working on the docs
bun run dev:docs # localhost:3001
bun run build:docs # resolves every icon name
bun run --filter=statshub-docs lint # resolves every internal /docs linkAdd a docs page covers frontmatter, sidebar
ordering, the components available in MDX, and when a page should be .md
rather than .mdx.