This release includes 1 breaking change for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
Affected surfaces
Summary
AI summaryScaffolded local secrets now use a single .env file across all platforms, replacing the deprecated .dev.vars.
Full changelog
Patch Changes
-
#1403
34dd430Thanks @scottbuscemi! - Scaffold local secrets into.envfor every platform, including Cloudflare — previously Cloudflare projects got.dev.vars.Since August 2025, Wrangler and the Cloudflare Vite plugin read
.envfiles in local development, so there's no longer a reason to split Node (.env) and Workers (.dev.vars). New projects now writeEMDASH_ENCRYPTION_KEYto a single.envfile regardless of platform, matching the dotenv convention most developers already expect.This is a deliberate, pre-1.0 hard switch away from
.dev.vars. It's called out as a minor bump rather than a patch because the scaffolded file changes name and the surrounding docs/guidance change with it.Backwards compatibility / upgrade notes:
- Existing projects are unaffected — a
.dev.varsyou already have keeps working; Wrangler still reads it. - Wrangler loads either
.dev.varsor.env, never both: if a.dev.varsfile is present its values win and.envis ignored entirely. If you migrate an existing project to.env, move your secrets across and delete.dev.vars, otherwise the new.envis silently shadowed. - When scaffolding into a directory that still contains a
.dev.vars,create-emdashnow prints a warning explaining the shadowing rule so the encryption key actually loads.
emdash secrets generate --writealready accepted any path and is unchanged; only the documented/suggested target moves to.env. - Existing projects are unaffected — a
Breaking Changes
- Removal of `.dev.vars` as the default secrets file; new projects scaffold `EMDASH_ENCRYPTION_KEY` into a single `.env` file.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About emdash
All releases →Related context
Related tools
Earlier breaking changes
- v@emdash-cms/[email protected] Requires Cloudflare Workers sites to add Cron Trigger and update entry point for scheduled publishing.
- [email protected] Schema migration adds `locale` and `translation_group` columns to `_emdash_bylines`.
- [email protected] Byline hydration now strictly per-locale, suppressing cross‑locale fallback.
- v@emdash-cms/[email protected] Changes `_emdash_content_bylines.byline_id` to store translation_group instead of row id, enforcing strict per-locale credit hydration.
- v@emdash-cms/[email protected] Registry install handler fails closed on non-conforming aggregator release records.
Beta — feedback welcome: [email protected]