Skip to content

docs(adr): ADR-0037 Live Canvas — draft-overlay live preview while you build - #1694

Merged
os-zhuang merged 2 commits into
mainfrom
adr-0037-live-canvas
Jun 11, 2026
Merged

os-zhuang merged 2 commits into
mainfrom
adr-0037-live-canvas

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Design proposal for the next big magic-moment iteration: a split-view Live Canvas — chat on the left, the user's app rendered from the draft overlay on the right, refreshing per-artifact while the agent builds/edits.

Design center: Airtable-class "say it, see it" feedback latency without giving up the ADR-0033 publish gate — the canvas renders the staged truth, so what you see is exactly what Publish will make real.

Grounded in verified primitives (file-level table in the ADR):

  • ?preview=draft overlay reads exist at list + item level — the SPA uses them nowhere today (the gap);
  • the streaming build tree + drafted envelopes already name every changed (type, name) in real time;
  • the assistantBus already bridges chat ↔ host (incl. an editor-context primitive for the phase-4 back-channel).

Four separately-shippable phases: ① static draft preview (~2–3 d, objectui) → ② event-driven live refresh (~3–4 d, objectui) → ③ draft data preview via in-memory seed overlay — the only new mechanism (~1–2 w, framework) → ④ canvas→chat "change this" back-channel (~3–4 d).

Status: Proposed — open for review; merging records the proposal, not an implementation commitment.

🤖 Generated with Claude Code

…u build

Proposes the split-view Live Canvas: chat on the left, the app rendered from
the DRAFT overlay on the right, refreshed per-artifact by the existing stream
events — Airtable-class "say it, see it" latency without giving up the
ADR-0033 publish gate (what you see is exactly what Publish will make real).

Grounded in verified primitives: ?preview=draft reads exist at list+item
level (unused by the SPA today), the build stream already names every changed
(type,name), and the assistant bus already bridges chat↔host. Four phases:
static draft preview → event-driven live refresh → draft DATA preview
(in-memory seed overlay, the only new mechanism) → canvas→chat back-channel.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 10, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 11, 2026 1:56am

Request Review

…udes)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 11, 2026
@os-zhuang
os-zhuang merged commit 5e62037 into main Jun 11, 2026
12 checks passed
@os-zhuang
os-zhuang deleted the adr-0037-live-canvas branch June 11, 2026 04:56

This branch was successfully deployed

1 active deployment
Preview — c6175476 Deployed Jun 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant