Visual editor
Open it with node sdk dev. Everything you do in the visual editor is an edit of your real files: the tree, selection and drag and drop all work on index.html as written, and every change goes through the same undo history as the code editor.
Selecting
- Select mode: hover outlines elements, click selects. The selection is mapped to the exact place in index.html (the preview's elements carry their source offset).
- Elements the engine creates at runtime (product cards, cart rows…) select the template element that contains them, with a note saying so.
- Interact mode uses the storefront normally (links, forms, cart).
- Placing the cursor on a tag in the code editor selects it too.
Layers
The tree of index.html, including template blocks (IF, FOREACH…). Badges mark engine hooks and routes; dots mark lines with problems. Filter by tag/id/class, show text nodes, drag rows to move elements (before, after or inside), right-click for actions.
Structural edits
Move, insert, nest, copy, cut, paste, duplicate (ids are removed from the copy so they stay unique), delete, wrap in a template block, rename the tag, edit attributes, classes and text. Edits that would break the document are refused: unbalanced template blocks, moving an element into itself or into a void element, or anything that introduces a parse error. Deleting an element the engine uses asks first and names the feature it switches off.
Insert
Engine blocks (markup taken from installed templates), route links and sections, plain HTML, placeholders and template blocks. Click to insert at the selection (before/after/inside/first child) or drag onto a layer.
Inspector panels
- Element — breadcrumb, template-block context, engine hook descriptions, tag, attributes (with route/action/image suggestions), classes, text, actions, computed size and styles from the preview.
- Styles — the rules in your stylesheet that match the element (editable: change, add or remove declarations; media rules that don't apply are marked) and the read-only rules from core.css/kit.css that also apply.
- Config — a form generated from the template.json schema (only keys the application reads, unless you ask for all), with limits and patterns checked as you type.
- Theme — branding colours with live preview, fonts (installed font list), corner radius, layout kit, labels.
- Meta — theme.json fields.
Saving, undo and history
Files save automatically about 0.6 s after a change; the top bar shows Saved, Saving… or Unsaved changes. Undo/redo covers visual and code edits. If a file changes on disk while you have unsaved edits, autosave pauses for that file and a bar lets you keep yours, take the disk version or compare.
Keyboard shortcuts
| Keys | Action |
|---|---|
| Ctrl/⌘ S | Save all files now (files also save automatically) |
| Ctrl/⌘ Z · Shift Z / Y | Undo · redo (visual and code edits) |
| Ctrl/⌘ P | Go to file |
| Ctrl/⌘ F | Find in file |
| Ctrl H · Shift Ctrl F | Replace |
| Alt G | Go to line |
| Shift Alt F | Format file |
| F12 · Ctrl-click | Find usages of the class/id under the cursor |
| Ctrl Space | Autocomplete (tags, attributes, engine hooks, routes) |
| { | Placeholder list (index.html) |
| Ctrl / | Toggle comment |
| Ctrl Q | Fold |
| Del | Delete selected element (Layers / preview) |
| Ctrl/⌘ D | Duplicate selected element |
| Ctrl/⌘ C · X · V | Copy · cut · paste the selected element (paste goes after the selection; ids are removed) |
| Alt ↑ / ↓ | Move selected element |
| ↑ / ↓ | Previous / next layer |
| Esc | Clear selection |
| Ctrl ` | Show/hide bottom panel |
| ? | This list |