Skip to content

fix(playground): install stable demo from WordPress.org, not git:directory - #73

Closed
dknauss wants to merge 1 commit into
mainfrom
fix/playground-stable-wporg-resource
Closed

fix(playground): install stable demo from WordPress.org, not git:directory#73
dknauss wants to merge 1 commit into
mainfrom
fix/playground-stable-wporg-resource

Conversation

@dknauss

@dknauss dknauss commented Jul 2, 2026

Copy link
Copy Markdown
Owner

What & why

The stable "Try it live" Playground demo — the primary link in the README — installed the plugin via a git:directory resource pinned to the release tag with path: "/". That pulled the entire 6.2 MB / 322-file dev repo (.planning/, tests/, .github/, docs/, bin/, phpcs/phpstan configs, package.json, …) into plugins/maestro-menu-editor/:

  • Slow & unreliablegit:directory is Playground's slowest, flakiest resource type (git-over-HTTP proxy) vs. the wp.org CDN Playground caches.
  • Not representative — a real wp.org install gets only the .distignore-filtered payload (includes/, assets/, languages/, two PHP files, readme), not the whole dev tree.
  • Maintenance tax — required bumping the blueprint ref every release via bin/prep-release.sh.

Maestro is published on WordPress.org, so this switches the stable demo to install from the directory via the "plugins" shorthand (same mechanism already used for user-switching in the same file). Result: byte-identical to a real install, CDN-fast, and auto-tracks the current Stable tag — no per-release edits.

Changes

  • playground/blueprint-stable.json — drop the git:directory installPlugin step; add maestro-menu-editor to the "plugins" array.
  • bin/prep-release.sh — no longer edits any blueprint (nothing to bump).
  • playground/README.md / README.md — update descriptions; remove the now-obsolete "Release rule" / post-tag-automation section.

blueprint-hosted.json (bleeding-edge main) intentionally keeps git:directory — it's the only zero-infra way to demo unreleased code.

Verification

  • blueprint-stable.json is valid JSON; prep-release.sh passes bash -n.
  • wordpress.org/plugins/maestro-menu-editor/ and the plugin-info API both return 200, confirming the slug resolves.
  • Manual check recommended before merge: open the stable demo URL once this lands on main and confirm it boots into edit mode with the plugin active. (The raw blueprint URL is served from main, so the demo reflects this change only after merge.)

🤖 Generated with Claude Code

…ctory

The stable "Try it live" demo cloned the plugin via a git:directory
resource pinned to the release tag with path "/", which pulled the entire
6.2 MB / 322-file dev repo (.planning, tests, CI configs, docs) into the
plugin folder — slow, unreliable, and not what users actually install.

Maestro is published on WordPress.org, so install it from the directory
via the "plugins" shorthand instead: byte-identical to a real install,
served from the Playground CDN, and it auto-tracks the current Stable tag.

This also removes the per-release blueprint ref-bump: prep-release.sh no
longer edits any blueprint, and the "Release rule" docs are updated to
match. blueprint-hosted.json still uses git:directory for bleeding-edge
main (the only zero-infra way to demo unreleased code).

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

dknauss commented Jul 2, 2026

Copy link
Copy Markdown
Owner Author

Superseded by #75, which fixed the git:directory blueprint via a CORS-proxy GitHub release ZIP (a different but valid self-tracking approach than this PR's WordPress.org slug). Closing in favor of that direction. Opening a small follow-up to fix the now-stale README references and make blueprint-stable.json self-track via /releases/latest/download/ (matching blueprint-hosted.json).

@dknauss dknauss closed this Jul 2, 2026
@dknauss
dknauss deleted the fix/playground-stable-wporg-resource branch July 3, 2026 01:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant