Manavarya09/moldui

Website  ·  npm  ·  Issues  ·  Watch the demo

npx moldui

Zero config. Auto-detects your dev server. Opens the browser. Every visual change becomes a real commit in your real code.

Every web dev has had this moment:

"This button needs 8 more pixels of padding."

Then you open your IDE, find the component, hunt the Tailwind class, tweak, save, switch tabs, squint, tweak again. Six steps for two pixels.

moldui kills that loop. Grab the button. Drag the corner. Done. Claude rewrites the source file, HMR reloads, you move on.

No plugin to install in your project. No framework lock-in. Works with Next.js, Vite, Vue, Svelte, Django, Rails, Laravel, Flask, plain HTML.

# 1. Start your dev server (any framework)
npm run dev

# 2. In a second terminal
npx moldui

That's it. The browser opens with your app plus the editor overlay injected.

Prefer a global install?

npm i -g moldui
moldui

Spatial editing that actually feels like a design tool. Not another "properties panel" bolted onto a preview.

• Click to select. Shift-click for multi-select.
• Drag to reorder. Alt-drag to swap two elements (they literally exchange positions in your source).
• 8-handle resize. Arrow keys nudge 1px. Shift+Arrow for 10px.
• Double-click text to edit inline — works on buttons, spans, links, headings.
• Full style panel: layout, typography, colors (with eyedropper + recent colors), spacing, borders, shadows. One-click presets for 4/8/16/24px.
• Layers panel (press L) — Figma-style DOM tree.
• Cmd+K palette — fuzzy search any element on the page.
• AI chat (Cmd+/) — natural language edits ("make this more modern").
• Spacing guides — hover while selected, see exact pixel distances between elements.
• Lock elements — right-click → Lock, prevents accidental selection.
• Viewport frames (375/768/1024/1280) with device chrome, not just width resize.
• Zoom with Cmd+Scroll like Figma canvas.

And the AI part. When you click Save:

1. Changes get compressed — 20 resize drags on one card coalesce into one change (keeps original from, latest to). Typical batch goes from 8KB to 1.5KB.
2. A batch file is written to .moldui/batch-{timestamp}.json
3. moldui spawns claude headless with --output-format stream-json
4. Claude reads the batch, edits your actual source files
5. You see live progress inside the browser overlay: Reading page.tsx → Editing... → ✓ Applied, 2 files changed
6. Auto-generated git commit message suggested in the terminal

No context switch. No "go run /slash-command in another window."

┌──────────────┐  WebSocket  ┌──────────────┐  spawn('claude') ┌─────────────┐
│  Browser     │ ──────────► │ moldui proxy │ ───────────────► │ Claude Code │
│  + overlay   │             │ (Node.js)    │   stream-json    │ (edits your │
└──────────────┘             └──────────────┘                  │  source)    │
       ▲                            │                          └─────────────┘
       │                            ▼                                 │
       │                    .moldui/batch.json                        │
       │                                                              │
       └──── live progress events ───────────────────────────────────┘
             (Reading, Editing, Applied)

1. Proxy wraps your dev server and injects a vanilla-JS editor inside a Shadow DOM
2. You edit visually — changes apply instantly as CSS overrides in the browser
3. Click Save → batch file written to .moldui/
4. Click Apply with Claude in the overlay → spawn('claude', ['-p', prompt, '--output-format', 'stream-json', '--verbose'])
5. Claude reads the batch, maps DOM descriptors to source files, makes minimal edits
6. Your framework's HMR picks up the real file change and reloads

Battle-tested against:

If your framework serves HTML, moldui works. The proxy doesn't care what rendered it.

The auto-apply feature needs Claude Code installed to run headlessly. But the batch format is AI-agnostic — any assistant can apply your edits by reading .moldui/INSTRUCTIONS.md.

If you use Claude Code, install the plugin for tightest integration:

claude plugin install Manavarya09/moldui

This wires /moldui-sync into Claude and enables the auto-apply flow — clicking Save in the browser triggers Claude headlessly, no terminal context-switch.

We welcome contributions — bug reports, feature PRs, framework adapters, docs fixes, issue triage, anything.

First time? Pick an issue labeled good first issue.

Ground rules (from CONTRIBUTING.md):

1. Editor stays vanilla JS — no framework dependencies in src/inject/
2. All editor UI renders inside a Shadow DOM — no style leaks into the host page
3. Every change type must be undoable — pass a revertFn to sendChangeWithUndo
4. Minimal diffs, match existing code style
5. Run node -c src/inject/editor.js before pushing

See the full CONTRIBUTING guide →

By participating, you agree to the Code of Conduct.

• v1 — drag, resize, text, styles, undo, save
• v2.0 — multi-select, layers, Cmd+K palette, AI chat, viewport frames
• v2.2 — glassmorphism theme, token optimization
• v2.3 — headless auto-sync, Apply panel, AI Suggest, Alt-drag swap
• v2.4 — spacing presets, element lock, commit message generator, all-blue theme
• v3 — collaborative editing (multiplayer), Figma two-way sync, plugin ecosystem

Have an idea? Open an issue.

moldui sits between you and your codebase. It's doing a lot of automation: injecting scripts, writing batch files, spawning Claude, rewriting source. I've tried to make it boring and predictable, but read the diffs before you commit. That's what the suggested commit-message prompt is for — a quick git diff before git commit -am "...".

• Bugs & feature requests: Open an issue
• Discussion: GitHub Discussions
• Security: see SECURITY.md — report vulnerabilities privately, not in issues

MIT © masyv

_{If moldui shipped a feature you wished existed — star the repo. It genuinely helps.}