1# Configuration reference23## Application configuration45`src/app.ts` is author-owned:67| Field | Purpose |8| ------------------- | -------------------------------------------------------------------- |9| `name` | Human-facing application name |10| `databaseName` | Prefix for the durable local database namespace |11| `schema` | Typed application schema exported by `src/schema.ts` |12| `storage` | Durable storage policy; generated projects use `"durable"` |13| `credentialOrigins` | Stable hostnames allowed for optional WebAuthn/device-credential use |14| `passkey.rpId` | Canonical production hostname for recoverable account passkeys |15| `sync.adapter` | Generated sync adapter selection |16| `repositoryUrl` | Source/home link displayed by the starter |1718Choose `databaseName` and stable credential origins before shipping. Changing them later can change19which local database or WebAuthn relying party the browser opens.2021Omitting `passkey.rpId` uses `location.hostname`. That is useful in local development, but each22preview hostname becomes a separate passkey namespace. Pin the stable production RP-ID before23offering passkey backup to real users.2425## Environment configuration2627| Name | Classification | Behavior |28| ------------------- | -------------- | ----------------------------------------- |29| `LOFI_BASE_PATH` | Public build | Mount path; defaults to `/` |30| `JAZZ_APP_ID` | Client-visible | Selects the managed Jazz application |31| `JAZZ_SERVER_URL` | Client-visible | Selects its sync endpoint |32| `JAZZ_ADMIN_SECRET` | Server-only | Used by schema and administrative tooling |33| `BACKEND_SECRET` | Server-only | Reserved for server-side integration |3435No `.env` selects local-only mode. A complete `JAZZ_APP_ID` and `JAZZ_SERVER_URL` pair makes sync36available. A partial pair is invalid and blocks affected commands.3738Process environment values take precedence over `.env`. Server-only values must never be prefixed as39public variables, imported into client code, or committed.4041## Build-time behavior4243The app is static, so public Jazz configuration is projected into the client during development or44build. Changing the deployment environment requires a new production build.