Unified · Split
| @@ -1,6 +1,7 @@ | ||
| 1 | 1 | # All env vars live in this single root .env file. |
| 2 | 2 | # Sub-packages load it via `with-env` scripts (bun --env-file). |
| 3 | −# Next.js vars are mapped from canonical names in next.config.ts. | |
| 3 | +# Env vars are read directly by the runtime; set VITE_* for client-exposed | |
| 4 | +# values and canonical names (such as CONVEX_URL) for server/runtime usage. | |
| 4 | 5 | |
| 5 | 6 | # ── Convex (required) ── |
| 6 | 7 | CONVEX_DEPLOYMENT=dev:your-deployment-slug |
| @@ -99,7 +99,8 @@ bun run convex:codegen · 98 unmodified lines | ||
| 99 | 99 | This repo uses a single root `.env` as the source of truth. |
| 100 | 100 | |
| 101 | 101 | - `assistant` and `executor` scripts read from root env-aware wrappers. |
| 102 | −- `executor/apps/web/next.config.ts` maps canonical vars (like `CONVEX_URL`) into `NEXT_PUBLIC_*` values for the client. | |
| 102 | +- `executor/apps/web` is a TanStack Start app; canonical vars are consumed by the app and injected at runtime. | |
| 103 | +- Client-facing values use `VITE_*` names where needed. | |
| 103 | 104 | - See `.env.example` for optional WorkOS, Stripe, tool-source API keys, and port overrides. |
| 104 | 105 | |
| 105 | 106 | ## Project Notes |