[josephfusco]

How to test

1. Static check (no Docker): from the repo root, run pnpm check:examples. It checks every example has the standard scripts, that every script/--prefix/README link it references exists, and that assets:unzip matches each zip's layout. CI runs the same check (new Example Scripts workflow). It reports 699 problems on main and none here.
2. Run an example (Docker): in any example directory, run npm run setup, then npm run dev. If port 8888 is taken, prefix both with WP_ENV_PORT=8977. Note: examples that read a WordPress URL from .env still need it created by hand until the .env.example follow-up lands.

Description

Standardizes the npm scripts across all 23 wp-env examples, using the names the team agreed in #330:

Script	What it does
setup	Installs dependencies, unzips media, starts WordPress, imports the DB. Doesn't start the front end.
dev	Starts WordPress and the front end.
app:dev	Starts only the front end, so you can restart the app without waiting on WordPress.
stop / clean	Stops / removes WordPress.
wp:start, db:import, db:export, db:query, assets:zip, assets:unzip	Scoped helpers.

Example-specific extras stay where needed: wp:multisite, app:styles:fetch (wp-theme-rendered-blocks), backend:dev (Angular). render-blocks-pages-router has no wp-env and is unchanged.

The scripts are documented once, in a new Running an example section of examples/README.md; each example's README links there instead of carrying its own copy.

Commits (one pass each)

1. Standardize the scripts across examples and READMEs.
2. Add a check (scripts/check-example-scripts.js, pnpm check:examples, CI workflow) and testing notes in examples/README.md.
3. Fix setup failures found end to end: ACF's GitHub release zip is now versioned, so the unversioned latest/download URL 404'd in 8 examples; and wp theme delete --all failed in the 3 examples using Twenty Twenty-One.
4. Install ACF from WordPress.org and pin WPGraphQL for ACF 2.4.1. afterStart ran wp plugin update wpgraphql-acf, which fails on a wp-env-mounted plugin whenever WordPress.org is newer, and WordPress.org is now on 3.0.0 (a major). Upgrading to 3.0 can be its own tested change.
5. README accuracy pass: drops per-example "setup does the following" lists that had already drifted, plus two wording fixes.

Bugs fixed along the way

• 9 examples ran without images: zips containing wp-env/uploads/... were unzipped with -d wp-env, extracting outside the mounted folder.
• WooCommerce never unzipped its media, and its zip contains the uploads twice.
• wp:destroy pointed at a config file that doesn't exist.
• Angular never installed example-app's dependencies; setup now does, and copies backend/.env.example (which had an empty FRONTEND_URL).
• webhooks-isr: pnpm → npm, wrong paths, and an echo > that overwrote the first .env line.

Related Issue

Closes #330. The .env.example suggestion from the thread follows in a separate PR.

Type of Change

• ✅ Bug fix (non-breaking change which fixes an issue)
• 📄 Example update (no functional changes)
• 📝 Documentation update

How Has This Been Tested?

pnpm check:examples passes for all 23 examples.

End to end with WP_ENV_PORT=8977 on 14 examples covering every framework, both zip layouts, and each special case. Before the fixes in commits 3–4, 7 of them failed setup; now all pass:

Example	setup	GraphQL	Media mounted	Front end
next/apollo-client-data-fetch	✅	200	152	—
angular/template-hierarchy	✅	200	201	200
astro/template-hierarchy	✅	200	—	200
nuxt/template-hierarchy	✅	200	201	200
nuxt/gravity-forms	✅	200	—	200
sveltekit/template-hierarchy	✅	200	201	500¹
next/woocommerce	✅	200	143	404²
next/client-multisite	✅	302³	113	500²
next/wp-theme-rendered-blocks	✅	200	—	200
next/custom-sitemap-apollo	✅	200	105	500²
hwp-previews/hwp-preview-rest	✅	404⁴	105	500²
hwp-previews/hwp-preview-wpgraphql	✅	200	105	500²
webhooks/webhooks-isr	✅	200	0⁵	200

¹ Hardcodes localhost:8888, which on this machine is another site, so CORS fails. ² No .env, so the WordPress URL is undefined (the .env.example follow-up). ³ The multisite network is registered to localhost:8888. ⁴ REST example, no WPGraphQL. ⁵ Its zip contains only empty folders.

Use of AI Tools

AI assistance: Yes
Tool(s): Claude Code
Model(s): Claude Opus 5.5
Used for: Assisting with the script standardization, the check script, end-to-end testing and fixes, README updates, and this PR description.

[github-actions]

📦 Plugin Artifacts Ready!

Download from GitHub Actions run

Available plugins:

• ✅ hwp-previews.zip
• ✅ wpgraphql-logging.zip
• ✅ wpgraphql-webhooks.zip

See the "Artifacts" section at the bottom of the Actions run page

[colinmurphy]

Thanks @josephfusco for fixing these issues 🚀

I ran pnpm check:examples locally and everything passed.