Introduction
Developer documentation for the TrueLabel monorepo.
TrueLabel is an open-source barcode scanner with a crowdsourced, community-verified nutrition database. Scan a packaged product, see real nutrition facts, and help verify or add labels the catalogue doesn't have yet.
This site documents the four things that make up the product, all in one monorepo:
Backend
Rust (Axum) API — product lookup, device auth, rate limiting, OCR submission, profile/subscription, crash reports.
iOS app
SwiftUI, iOS 26.5+. Scan, verify, history, and profile — talks to the
backend over a typed APIClient.
Dashboard
Internal staff tool — triage crash reports, manage who has access, publish a report straight to a GitHub issue.
Web
Turborepo (bun) — the marketing site, this docs site, and the
dashboard, sharing a @repo/ui design-token package.
Where to start
- New to the repo? Getting Started gets all four apps running locally.
- Want the shape of the whole system first? Architecture.
- Building a client against the API? API Reference.
- Triaging crash reports or managing staff access? Dashboard.
- Opening a PR? Contributing.
Accuracy over completeness
Every page here is written against the code as it exists today, not a plan or an aspiration. Where something is deliberately simplified or not yet built, the page says so directly rather than describing it as done.

