Skip to content
Menestrel

Environment variables

The loader reads these variables at build time. They resolve in a strict order, described in the loader reference.

Variable Role
MENESTREL_OFFLINE Set to 1, reads .menestrel/snapshot/ with no network. Highest priority.
MENESTREL_CONTENT_URL URL of the published snapshot. The nominal production path. Accepts an ordered list for fallback.
MENESTREL_TOKEN Read token, lets the loader discover the latest snapshot through the API. Keep it to development.
MENESTREL_API_URL Overrides the API base URL.
MENESTREL_SNAPSHOT_ID Pins a specific snapshot, for a byte-for-byte reproducible build.

Production recommendation

Section titled “Production recommendation”

Set MENESTREL_CONTENT_URL to the published snapshot URL. The build then no longer depends on the application: if the admin is under maintenance, the site still rebuilds. This is the intended behavior, not a degraded mode.

Fenêtre de terminal
# In production (Vercel, Netlify, CI...)
MENESTREL_CONTENT_URL=https://content.menestrel.dev/p/prj_xxx/pk_xxx

Do not set MENESTREL_TOKEN in production: a build that depends on a live service can break at the worst time.