Skip to content

Explore a standalone Playground Workbench mockup#3658

Draft
adamziel wants to merge 11 commits into
trunkfrom
adamziel/playground-ui-directions
Draft

Explore a standalone Playground Workbench mockup#3658
adamziel wants to merge 11 commits into
trunkfrom
adamziel/playground-ui-directions

Conversation

@adamziel
Copy link
Copy Markdown
Collaborator

@adamziel adamziel commented May 19, 2026

What it does

Replaces the prior Workbench-centered mockup with a standalone browser/tools model for Playground under packages/playground/website/design-explorations/. It does not change the production Playground app.

Open it directly:

packages/playground/website/design-explorations/workbench-html-mockup.html?panel=runtime

Useful states are runtime, files, current, share, and command.

Rationale

The direction keeps the parts users like: Playground stays full-page, the address bar remains central, and Playground UI stays outside the WordPress canvas. The UI now uses a much simpler WordPress/Gutenberg-like system instead of a decorative mockup language: white surfaces, WordPress grays, blue only for primary actions, and amber only for recovery state. Borders are used deliberately for structure—runtime fields, tool categories, and the long Playgrounds table—instead of being removed entirely.

The broader feature surface is no longer treated as “the command palette will solve it.” The Tools entry now promotes five common tasks—Runtime, Files, Import, Your Playgrounds, and Save/share—and demotes less frequent tools into short chips. Search is present, but secondary. This keeps the feature surface discoverable without a wall of similar actions.

The current-site card now clearly opens Your Playgrounds. That panel is designed for a realistic 30-item library with filtering, Saved/Recovery/Local tabs, metadata columns, a scrollable list, and quick create/import actions.

Runtime and save/recovery state remain visible before any click. Clicking Environment opens a focused sheet with the two primary operations: Save this Playground and Change runtime. Files still opens as a bottom recovery drawer with usable editor width.

Implementation

The mockup is static HTML/CSS/JS so it can be reviewed without wiring unfinished UX into React components.

This replaces the old 100-iteration scorecard with a lightweight browser/environment validator:

node packages/playground/website/design-explorations/workbench-html-mockup-iteration-runner.mjs

The validator writes screenshots and a manifest to .context/workbench-browser-environment-checks/ and checks address visibility, Environment visibility, WordPress canvas ownership, expected labels/actions, bounded transient surfaces, intentional structural-border budgets, Playground-vs-WordPress separation, and Files editor readability.

Testing instructions

Latest local checks:

node packages/playground/website/design-explorations/workbench-html-mockup-iteration-runner.mjs
node --check packages/playground/website/design-explorations/workbench-html-mockup-iteration-runner.mjs
git diff --check
npm exec nx run playground-website:typecheck
npm exec nx run playground-website:lint

Results: 24 screenshots across 6 states and 4 desktop breakpoints, 0 failures. I also checked the Playgrounds library and Tools browser in Chrome at 1440×900; the address bar remains visible and the console is clean.

@adamziel adamziel changed the title Explore Playground UI directions Build the full-page Playground browser shell May 19, 2026
@adamziel adamziel force-pushed the adamziel/playground-ui-directions branch 2 times, most recently from 1dbbcfb to 7a646e4 Compare May 20, 2026 10:23
@adamziel adamziel force-pushed the adamziel/playground-ui-directions branch from a2a14b7 to 73842c7 Compare May 20, 2026 14:00
@adamziel adamziel changed the title Build the full-page Playground browser shell Explore a standalone Playground Workbench mockup May 20, 2026
@adamziel
Copy link
Copy Markdown
Collaborator Author

Uploaded the screenshot set for review in this commit: 5a2b0e4.

Gallery:
https://github.com/WordPress/wordpress-playground/blob/adamziel/playground-ui-directions/packages/playground/website/design-explorations/playground-redesign-screenshots.md

It includes final desktop/mobile/error states, current Playground reference screenshots, and the PR #3658 reference states captured during the redesign pass.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant