Skip to main content

6. Keepin' Tracks — Cloudflare edge stack

Date: 2026-05-03

Status​

Accepted

Context​

Keepin' Tracks is the consumer web app for personal wealth, mind, and health data. It must scale on a modest budget, deploy globally, and stay aligned with our Cloudflare-first posture. Production hostname: personal.keepintracks.com.

Decision​

  • Frontend: React Vite app in apps/tracks-web, responsive web-first (PWA-ready later), deployed to Cloudflare Pages with custom domain personal.keepintracks.com (attach in Cloudflare Pages → Custom domains).
  • API: Hono on Cloudflare Workers in apps/tracks-api, same zone/account; routes under /api/v1 with /health for probes.
  • Local dev: Vite dev server proxies /api and /health to wrangler dev on port 8787.

Consequences​

  • Positive: Single vendor edge story, low ops overhead, Bun monorepo consistency.
  • Positive: Clear split between static UI and Worker API for future Hyperdrive, Queues, and R2 bindings.
  • Tradeoff: Workers runtime constraints (no Node APIs); use Web APIs and compatible libraries.