Environment Variables
core-api
Section titled “core-api”| Variable | Required | Description |
|---|---|---|
ENVIRONMENT | yes | development / production |
TRUST_SECRET / INTERNAL_TRUST_SECRET | prod only | HMAC secret shared with edge-gateway |
AUTH_SECRET / JWT_SECRET | prod only | Admin / session JWT signing |
DB | yes | D1 binding → core-d1 |
GRAPH_SHARD | yes | Durable Object binding |
BUCKET | optional | R2 binding → core-r2 |
edge-gateway
Section titled “edge-gateway”| Variable | Required | Description |
|---|---|---|
ENVIRONMENT | yes | development / production |
TRUST_SECRET / INTERNAL_TRUST_SECRET | prod only | Same HMAC secret as core-api |
CORE_API | yes | Service binding to Worker core-api |
ops-control
Section titled “ops-control”| Variable | Required | Description |
|---|---|---|
ENVIRONMENT | yes | Deployment environment |
DB | yes | D1 binding → core-d1 |
BUCKET | optional | R2 binding → core-r2 |
EMAIL_WORKER_SECRET | prod only | Auth to infra-email |
infra-email
Section titled “infra-email”| Variable | Required | Description |
|---|---|---|
RESEND_API_KEY | yes | Resend transactional email API key |
FROM_EMAIL | yes | Sender address |
OPS_EMAIL | yes | Operator email for backup/usage alerts |
ENVIRONMENT | yes | development logs to console instead of sending |
web-public (docs + marketing)
Section titled “web-public (docs + marketing)”| Variable | Required | Description |
|---|---|---|
PUBLIC_SITE_TITLE | no | Product name shown in nav and <title> |
PUBLIC_TAGLINE | no | Hero tagline |
PUBLIC_DESCRIPTION | no | Meta description |
PUBLIC_SITE_URL | no | Canonical URL of this site |
PUBLIC_DOCS_URL | no | Path to first docs page |
PUBLIC_DASHBOARD_URL | no | Tenant dashboard URL |
PUBLIC_API_BASE_URL | no | API base URL shown in docs examples |
PUBLIC_SUPPORT_EMAIL | no | Support / sales contact email |
PUBLIC_GITHUB_ORG | no | GitHub organization slug |
app-dashboard
Section titled “app-dashboard”| Variable | Required | Description |
|---|---|---|
NEXT_PUBLIC_PRODUCT_NAME | no | Product name in UI |
NEXT_PUBLIC_API_BASE_URL | yes | Public API base URL (edge-gateway) |
NEXT_PUBLIC_AUTH_URL | yes | Auth endpoint for the tenant dashboard |
NEXT_PUBLIC_DOCS_URL | no | Link to docs site |
core-admin (Pages)
Section titled “core-admin (Pages)”| Variable | Required | Description |
|---|---|---|
VITE_PRODUCT_NAME | no | Product name in control-plane topbar |
VITE_API_BASE_URL / VITE_CONTROL_PLANE_API_URL | yes | core-api base URL |
VITE_INTERNAL_JWT_ISSUER | yes | JWT issuer for admin session validation |