@deneb-ui/cli

Scaffold, convert, validate, and ship Fivora-ready storefront templates.

CLI Reference · Installation · GitHub

Quick start

# Convert an existing Next.js app (Deneb ARC — default engine)
npx @deneb-ui/cli init

# Preview the transformation plan without writing files
npx @deneb-ui/cli init --explain

# Validate Fivora contract compliance
npx @deneb-ui/cli validate .

# Package a clean upload ZIP
npx @deneb-ui/cli validate --zip

Install as a dev dependency:

npm install -D @deneb-ui/cli
# Command: deneb

Editable icons in Local Lab

Bridge v54 also recognizes style-only card targets and sends their styleType without treating container contents as editable text. Padding/margin values of zero and container gap are supported by the live style updater.

Bridge v53 preserves control in element-click messages. Icon targets also send iconType and iconName from the existing EditableIcon attributes. An icon name is still stored as schema type text; the parent editor must use control: 'icon-picker' to select its existing icon picker rather than its text editor. That parent UI is maintained in the Fivora developer-panel repository. This bridge metadata does not implement or replace the parent picker UI.

Preview bridge v52 recognizes EditableIcon SVG targets, including clicks on their child paths. Icon updates are rendered through the site-data provider; the generic text updater must not replace SVG children with the icon name. Restart an existing Lab process and refresh its preview after upgrading the bridge. Verify icon selection, saving, and reloading in the connected editor.

Commands

Full reference: deneb.fivora.site/docs/cli

Local preview before upload

Run deneb lab . in a template project, then paste the printed controller URL and token into Developer Portal → Local Test Lab. Content and style edits are applied to the preview immediately. Use Save local to persist the current editor state to the siteDataFile declared in fivora-template.json; the write stays on your machine and no template files are uploaded. Run Test after saving to perform the same local preflight checks used before packaging.

What deneb init does (ARC)

1. Scans your Next.js project — routes, dependencies, reachable pages
2. Analyzes JSX for editable text, images, URLs, collections, CTAs
3. Transforms source via AST — injects preview markers and site-data bindings
4. Generates fivora-template.json + site-data.json with strict self-validation
5. Backs up changed files to .deneb-backup-* for safe rollback

Authors

Created and maintained by Chamika Gayashan and Induranga Kawishwara.

_{MIT © DENEB UI}