npm i -g praetoriusCLI Reference
prae init— scaffold a project.prae generate --skin <name> [--ui-runtime vanilla|react] [--palette <name>] [--cursor <preset>] [--hover-effect <preset>] [--button-effect <preset>] [--mono-color <hex|oklch>]— build a works block.prae generate --embed— emit a single CMS snippet.prae import / export— move data in/out.prae doctor— validate works data.
Runtime notes:
- React runtime currently supports:
vite-breeze,cards-tabs,kiosk,docs-reader. - For those skins,
--embedalways falls back to vanilla output (with a console note).
Docs Reader notes:
.prae/docs.jsonsupportssearch.engine: auto|light|fuse|none.autois default and selects lightweight vs fuzzy indexing based on docs size.- Markdown frontmatter supports
heroand typedmodules[](score,media,process,credits).
Appearance notes:
- Default palette:
orange-blue-white-silver. - Palette choices:
ryb-tricolor,mono-bw,mono-one,gem-diamond,orange-blue-white-silver. - Cursor choices:
system,block-square,ring,prism-diamond. - Hover/button effect choices:
minimal,balanced-neo,high-drama. --mono-coloris used with--palette mono-one(HEX or OKLCH input; normalized to stored OKLCH).consoleskin applies palette + mode only and ignores cursor/effect presets.
Branding notes:
- Global attribution config:
ui.branding.attribution.enabled(defaulttrue). prae siteincludes an explicit “Show Powered by Praetorius” toggle.- Backward compatibility: legacy
site.showBadge === falseis normalized toui.branding.attribution.enabled = false. - Generated HTML now includes skin-agnostic branding markers:
data-brand-system=\"praetorius-v1\"data-brand-attribution=\"on|off\"
See also: Recipes and Troubleshooting.