Skip to content

docs(builder-ui): document Automation/Interface as built + design Access/Settings (#2506) - #2511

Merged
os-zhuang merged 1 commit into
mainfrom
docs/builder-ui-pillars-writeback
Jul 2, 2026
Merged

os-zhuang merged 1 commit into
mainfrom
docs/builder-ui-pillars-writeback

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Follow-up to ADR-0084 and the living docs/design/builder-ui.md (merged in #2503). Closes the remaining-pillars design tracked in #2506.

What

  • Writeback the Data pillar + shell sections to the shipped StudioDesignSurface reality: the field-edit affordance is the per-column pencil (a bare header click sorts — the grid is the runtime ListView); three pillars ship first (Access/⚙ pending); Save/Publish render per-pillar; the Interface rail is the app's real nav tree. Added an honest Implementation status note and per-surface [built] / [designed] markers.
  • Replace the §5 "to design" stub with four real sections:
    • §5 Automation [built] — flow canvas (FlowCanvas) + node inspector + Runs peek.
    • §6 Interface [built] — source+preview (SchemaRenderer) / structured canvas + component props.
    • §7 Access [designed] — permission matrix (PermissionMatrixEditor) + role protocol form.
    • §8 Settings [designed] — General (app form) + Advanced/Code (hooks), grouped by audience.
  • Each pillar gets an annotated HTML mockup under builder-ui/ composed from shell.css, every region tagged data-build="shell" or data-reuse="<component>" (dashed = reused). Added the shared canvas / matrix / split / settings primitives to shell.css.

Scope

Docs only. Deliberately excludes the unrelated console-sha-drift-guard changes present in the working tree — this PR is the six builder-ui doc files only.

Closes #2506.

🤖 Generated with Claude Code

…ess/Settings (#2506)

Complete the living builder-ui design doc. Writeback the Data/shell sections to the
shipped StudioDesignSurface reality (pencil edit affordance vs. header-click-sorts;
three-pillars-first; Save/Publish placement; Interfaces nav tree), and replace the
§5 "to design" stub with four real sections — Automation and Interface documented
as-built, Access and Settings designed — each with an annotated shell.css mockup
(data-build / data-reuse, dashed = reused). Addresses #2506.

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

vercel Bot commented Jul 2, 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 Jul 2, 2026 2:34am

Request Review

@github-actions github-actions Bot added size/l documentation Improvements or additions to documentation labels Jul 2, 2026
@os-zhuang
os-zhuang merged commit 84b08da into main Jul 2, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the docs/builder-ui-pillars-writeback branch July 2, 2026 02:37

This branch was successfully deployed

1 active deployment
Preview — 708e5a68 Deployed Jul 2, 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/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Design: application builder UI — remaining pillars (Automation / Interface / Access / Settings)

1 participant