Overview
The TypeScript stack is for rich client-side apps. It ships a React SPA with Vite, a pnpm/turbo monorepo, and shared packages. Use it standalone or pair it with the Python backend via the hybrid stack pattern.
The service lives at web/ts/ and is deployed via Kamal with the config at config/deploy/ts-web.yml.
Stack
- Framework: Next.js
- Monorepo: Turborepo (
web/ts/apps/web/) - Port: 3000
Local development
cd web/ts
make install
make dev
Deployment
make kamal ARGS="ts-web deploy"
The Kamal config builds from web/ts/apps/web/Dockerfile with the build context set to web/.
Environment variables
No clear environment variables are configured by default. Add them to the env.clear section in config/deploy/ts-web.yml as needed.
Health check
Kamal checks / for readiness.