wp-playground

Create disposable WordPress playgrounds for testing plugins and themes.

9|1|Updated Sep 10, 2022
One-click install
npx skills add https://github.com/WPdoaction/animal-shelter --skill wp-playground-wpdoaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-playground
Source: https://github.com/WPdoaction/animal-shelter/tree/main/.claude/skills/wp-playground
Command: npx skills add https://github.com/WPdoaction/animal-shelter --skill wp-playground-wpdoaction

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

WordPress Playground provides fast, disposable WordPress environments that you can spin up in the browser or locally to safely test plugins, themes, and configurations without a full-stack setup.

Core Features & Use Cases

  • Auto-mountable plugin/theme environments for quick testing.
  • Run and iterate on Playground Blueprints (JSON) locally to reproduce setups.
  • Build reproducible snapshots of a site for sharing or CI.
  • Switch WordPress and PHP versions quickly to reproduce issues.
  • Debug plugin/theme code with Xdebug in an isolated Playground.

Quick Start

Install and run the Playground CLI: npx @wp-playground/cli@latest server --auto-mount Open http://localhost:9400 to access the disposable WordPress instance, or run a blueprint with: npx @wp-playground/cli@latest run-blueprint --blueprint=<file-or-url> Build a snapshot with: npx @wp-playground/cli@latest build-snapshot --blueprint=<file> --outfile=./site.zip Switch WP/PHP versions using --wp and --php as needed.

Frequently Asked Questions about wp-playground

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I spin up a disposable WordPress environment for testing plugins locally?

You can spin up a disposable WordPress environment locally by running the @wp-playground CLI server command with the auto-mount flag, then accessing the instance at localhost:9400 to test plugins without a full-stack setup.

What is a WordPress Playground Blueprint and how does it reproduce site setups?

A WordPress Playground Blueprint is a JSON file that defines reproducible site configurations. You run it locally with the CLI to automatically mount plugins, apply themes, and reproduce exact setups for testing or CI.

Does WordPress Playground support switching PHP and WordPress versions for debugging?

Yes, WordPress Playground supports switching PHP and WordPress versions. You can use the --wp and --php CLI flags to quickly reproduce issues across different environment configurations during debugging.

Do I need Node.js to run a WordPress environment in WebAssembly?

Yes, you need Node.js 20.18 or higher to run the @wp-playground CLI, which executes WordPress in WebAssembly with SQLite to provide isolated, disposable testing environments.

How do I build a reproducible snapshot of a WordPress site for sharing?

You build a reproducible snapshot of your WordPress site by passing a blueprint file to the build-snapshot CLI command with an output flag, generating a portable site.zip archive for sharing or CI.

Can I debug WordPress plugin code with Xdebug in an isolated playground?

Yes, you can debug WordPress plugin code with Xdebug in an isolated Playground, allowing you to safely iterate and troubleshoot plugin or theme code without impacting your local machine setup.