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

docs(builder-ui): document Automation/Interface as built + design Access/Settings (#2506)#2511
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
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