Keepin' Tracks — application architecture
Keepin' Tracks is the personal operating system for Wealth, Mind, and Health—deployed at personal.keepintracks.com. It is intentionally calm utility, not “motivation product” positioning.
Repository packages
| Path | Purpose |
|---|---|
apps/tracks-web | React (Vite) client; Tailwind; pillar shell |
apps/tracks-api | Hono API on Cloudflare Workers |
packages/tracks-contracts | Shared constants and types (API prefix, pillars) |
Edge stack
See ADR 0006: Pages + Workers + personal.keepintracks.com. Internal docs live at devdocs.keepintracks.com (ADR 0009).
Data layer
See ADR 0007: Postgres + Hyperdrive for relational scale (transactions, journaling metadata, health metrics).
Local development
From repo root (two terminals):
bun run tracks-api:dev
bun run tracks-web:dev
The web app proxies /api and /health to the Worker on 127.0.0.1:8787.
Deploy from local builds
Production deploy uses Wrangler after local bun run builds—see Deployment & access and ADR 0009. Root scripts: bun run deploy:docs, bun run deploy:tracks-web, bun run deploy:tracks-api.
Next steps (implementation)
- Auth provider + sessions (ADR to follow).
- Drizzle (or equivalent) schema with strict
user_idtenancy. - Wealth module: accounts + cursor-paginated transactions.
- Stripe billing webhooks (optional monetization).