CLI tools

gen.mjs

Scaffolds src/blocks/<Name>/ with a stub .astro (wrapped in <Wrapper>) and a minimal .schema.json (fields: {}).

node gen.mjs MyBlock

Run from the project root. The new block is auto-synced into BlockRenderer.astro on next MagiCMS commit.

upgrade-scaffold.mjs

Apply scaffold migrations to a user project.

node packages/ui/scripts/upgrade-scaffold.mjs /path/to/project          # dry-run stepwise
node packages/ui/scripts/upgrade-scaffold.mjs /path/to/project --apply

Default dry-run. Flags: --apply, --force, --hard-update.

generate-block-previews.mjs

Regenerate preview.svg thumbnails for every block. Run in packages/ui/.

generate-theme-library.mjs

Regenerate theme files from palette sources. Run in packages/ui/.