Architecture
Architecture Overview
Technical stack and design decisions.
Principles: composability, TypeBox on Fastify routes generate OpenAPI, multiple clients, documented Vercel + Supabase path, tooling with long-term support.
Topics
- Monorepo — Turborepo, apps, packages
- API — Fastify 5, TypeBox, OpenAPI,
@repo/core - AI — Providers,
/ai/chat,/ai/generate, web assistant - Authentication — Magic link, OAuth, Web3
- Account linking — Email change, OAuth, wallets
- Frontend — Next.js 16, React 19, Tailwind 4. No wallet UI in
apps/web. - Error handling —
@repo/error, log-only capture (Sentry installed, inactive) - Logging — Pino / console,
reqId - Product analytics — PostHog chosen, not shipped; web instrumented, not collected
- Security — Secrets, CVE scans, DeepSec
- ESM & TypeScript — TypeScript 7, dual-mode exports
- Portability — shipped Vercel + Supabase; GCP/AWS not first-class
Decisions: ADRs.