velloo 0.4.1 → 0.6.0

package/README.md

@@ -128,7 +128,7 @@ required to design, export, or implement a screen.
 
 ## Features
 
-- **Existing-screen redesign.** Start from a React route or a captured
+- **Existing-screen redesign.** Start from a React or HTML route, or a captured
   authenticated page, recreate a faithful baseline, explore alternatives, and
   compare against the running product at the same viewport.
 - **Real components, not approximations.** Components come from a
@@ -136,8 +136,9 @@ required to design, export, or implement a screen.
   client-safe files from your app mount directly in the canvas; portal- and
   state-heavy families are explicitly adapted; compile failures fall back per
   component with diagnostics.
-- **Five React adapters.** shadcn + Tailwind, Material UI, Ant Design, Chakra
-  UI, and no-library React each render and emit through their own adapter.
+- **React and HTML/htmx adapters.** shadcn + Tailwind, Material UI, Ant Design,
+  Chakra UI, and no-library React render through their own adapters. The HTML
+  adapter previews live server fragments and emits native HTML.
 - **Visual verification.** The agent inspects rendered nodes, takes screenshots,
   diffs against a live URL, and fixes what it sees instead of guessing from code.
 - **Board → Screen → Frame.** One design folder holds many boards; frames that
@@ -153,7 +154,7 @@ required to design, export, or implement a screen.
 | | |
 |---|---|
 | **OS** | macOS (arm64, x64), Linux (arm64, x64; glibc and musl), and Windows (x64, arm64) through npm. The standalone installer is macOS and Linux only. |
-| **Your app** | React. shadcn + Tailwind, MUI, Ant Design, Chakra, and no-library folders are supported. |
+| **Your app** | React (shadcn + Tailwind, MUI, Ant Design, Chakra, or no-library) or a server-rendered HTML/htmx app. |
 | **Screenshots** | Optional headless Chromium, one command away (below). |
 
 ### Screenshots — the one optional extra
@@ -184,7 +185,7 @@ the design as `--design`.
 | `velloo init` | Create a design folder and wire up your agent |
 | `velloo run [design]` | Start the canvas + MCP daemon (`--port` to pick the canvas port) |
 | `velloo design list\|add\|remove\|move\|rename\|upgrade` | Manage the repo's designs |
-| `velloo emit` / `velloo render` | Implementation IR for your agent / a PNG of a screen |
+| `velloo emit` / `velloo render` | Implementation IR (native HTML for an HTML screen) / a PNG of a screen |
 | `velloo publish [design]` | Publish a board for review (`publish list\|remove` manage what you've published) |
 | `velloo upgrade` | Update the install *and* migrate the design format (`--check` to preview) |
 
@@ -204,6 +205,27 @@ and pays for a native schema only when it needs one. Clients that do better with
 conventional function schemas can use `velloo mcp --surface full`. Both surfaces
 carry the whole operation catalogue. See [docs/mcp.md](./docs/mcp.md).
 
+### HTML and htmx apps
+
+Run `velloo init --library html --initial-content scan` from a server-rendered
+app (Flask, FastAPI, Django, Rails, Laravel, …), or choose **HTML + htmx** in the
+wizard; `init` picks it on its own for an app with templates and no React.
+Velloo scans its routes into placeholder screens and copies the stylesheets its
+templates link (`hostApp.stylesheets`) from the app's source into the design's
+`assets/host/`. A design never contacts the running app: it is a fixed picture
+that looks the same to everyone who opens it, with or without the app. To
+reproduce a page, capture it from the running app with a capture session (you
+sign in in a separate browser if it needs it) and have the agent rebuild it
+from the capture. CSS that only exists once the app is built comes from the
+capture too (`store_host_files`).
+
+Use `Html` nodes with semantic `as` tags, native attributes, and `hx-*` props.
+The canvas never fires the `hx-*` attributes; `emit_code` keeps them and
+returns HTML with the classes and routes it relies on, `velloo emit <screen> --to
+page.html` writes native markup for a template, and `emit_theme` writes the CSS
+custom properties that inline styles reference. Integrate the markup with your
+server's template language and handlers; Velloo does not generate server routes.
+
 ## Local-first by default
 
 The local tool is free, complete, account-free, and telemetry-free.
@@ -237,7 +259,7 @@ You choose when — and whether — to use any of them.
 
 Contributions are welcome — bug reports, adapters, docs, and design feedback
 alike. [`CONTRIBUTING.md`](./CONTRIBUTING.md) covers setup and the checks we
-expect to be green; [`CLAUDE.md`](./CLAUDE.md) explains the repo's architecture
+expect to be green; [`AGENTS.md`](./AGENTS.md) explains the repo's architecture
 invariants before you change anything load-bearing.
 
 The short version:
@@ -262,7 +284,7 @@ Velloo is a Bun-workspaces monorepo with one-way dependencies:
 | `packages/schema` | Zod schemas + TS types for the on-disk design-folder format |
 | `packages/protocol` | The wire contract: mutation arguments, typed errors, watch events |
 | `packages/provider` | The `ComponentProvider` / `FrameworkAdapter` interface |
-| `packages/provider-*` | shadcn, MUI, Ant Design, Chakra, and no-library adapters |
+| `packages/provider-*` | shadcn, MUI, Ant Design, Chakra, no-library, and HTML/htmx adapters |
 | `packages/shadcn-snapshot` | Pinned canvas-safe shadcn fallback, embedded in the binary |
 | `packages/renderer` | Design JSON → HTML (and PNG via Playwright) |
 | `packages/codegen` | Agent-consumed IR + theme emitters |