Title: Page 2 – Alex Kirk

---

 * 
   ## 󠀁[WordPress Development Without a Computer](https://alex.kirk.at/2025/11/29/wordpress-development-without-a-computer/)󠁿
   
 * November 29, 2025
 * ![](https://alex.kirk.at/wp-content/uploads/sites/2/2025/11/Screenshot-2025-11-
   29-at-15.13.15.png)
 * You’re on the train, scrolling through your WordPress site on your phone, and
   you see an issue that you’d like to fix, for example improvement to the mobile
   view. Normally you’d make a (mental) note and deal with it when you’re back at
   your computer.
 * But what if you could just fix it right there?
 * With AI coding assistants that run in the browser—like [Claude Code](https://claude.ai/code),
   [OpenAI Codex](https://openai.com/codex/), [GitHub Copilot Workspace](https://githubnext.com/projects/copilot-workspace),
   or similar tools—combined with [WordPress Playground](https://playground.wordpress.net/)
   for testing, you can now do WordPress plugin development without a computer.
 * 
   ## What It Looks Like
   
 * > AI: I’ve implemented the fix for you, committed and pushed it to Github. Use
   > this link to [Test it in WordPress Playground](https://playground.wordpress.net/).
 * This link above just leads to a generic Playground but to give you an idea of
   the workflow: The AI helps you fix or implement what you asked for and makes 
   the code available in a branch. You’ll then run/view it via Playground. Here’s
   how to set this up:
 * 
   ## What You Need
   
    - Your plugin or theme in a GitHub repository,
    - A web AI coding assistant,
    - A way to tell the AI how to generate Playground test links that you can click.
 * The third part is where the [Playground Step Library](https://akirk.github.io/playground-step-library/)
   comes in.
 * 
   ## Step 1: Create Your Blueprint
   
 * WordPress Playground uses [blueprints](https://wordpress.github.io/wordpress-playground/blueprints-api/index/):
   JSON configurations that describe what to install and how to set things up. You
   can install plugins, themes, configure settings, import content, and more. Writing
   these by hand is a little cumbersome, so I built the Step Library as a visual
   tool to assemble blueprints step by step.
 * The Step Library also provides more steps than Playground offers natively: that’s
   where the name comes from. It compiles these custom steps into the native steps
   that Playground understands. The native steps are powerful but require you to
   know how to combine them in clever ways; the Step Library’s [custom steps](https://github.com/akirk/playground-step-library/tree/main/docs)
   make it easier. Examples include [addProduct](https://github.com/akirk/playground-step-library/blob/main/docs/steps/addProduct.md)
   for WooCommerce, [addTemplatePart](https://github.com/akirk/playground-step-library/blob/main/docs/steps/addTemplatePart.md)
   for block themes, a [debug](https://github.com/akirk/playground-step-library/blob/main/docs/steps/debug.md)
   step to enable common debug settings and plugins, or [disableWelcomeGuides](https://github.com/akirk/playground-step-library/blob/main/docs/steps/disableWelcomeGuides.md).
 * Use [this special link to the Step Library](https://akirk.github.io/playground-step-library/?step%5B0%5D=installPlugin)
   to start with an [“Install Plugin” step](https://github.com/akirk/playground-step-library/blob/main/docs/steps/installPlugin.md).
   Paste your HTTPS GitHub repository URL. If you want to test a specific branch,
   add `/tree/branch-name` to the URL—but for now, just use your main branch. We’ll
   make the branch dynamic later.
 * Add any other steps your testing environment needs: maybe WooCommerce if your
   plugin integrates with it, or some test content, or specific WordPress settings.
 * 
   ## Step 2: Generate AI Instructions
   
 * Once your blueprint is ready, open the “Copy/Share” dropdown and select “Generate
   AI Instructions”. This creates a markdown snippet you can add to your project’s`
   CLAUDE.md`, `.github/copilot-instructions.md`, or similar AI instruction file:
 * ![](https://alex.kirk.at/wp-content/uploads/sites/2/2025/11/copy-dropdown-menu.
   png)
 * ![](https://alex.kirk.at/wp-content/uploads/sites/2/2025/11/generate-ai-instructions-
   1024x929.png)
 * The generated instructions tell the AI to include a Playground testing link at
   the end of its responses. The branch name in your URL gets replaced with a `BRANCH_NAME`
   placeholder, so the AI knows to substitute the actual branch it’s working on.
 * 
   ## Step 3: Add to Your Repository
   
 * Copy the generated markdown and add it to your AI instruction file. Commit it
   to your repository. Now any AI assistant that reads these instructions will include
   Playground links when it makes changes to your code.
 * Bonus: you can also instruct your coding assistant to add such a file to your
   repo!
 * 
   ## The Workflow
   
 * Here’s what this looks like in practice:
    1. Open your AI coding assistant on your phone (or desktop),
    2. Connect to your GitHub repository,
    3. Describe what you want to change or fix,
    4. The AI makes the changes and pushes a branch,
    5. Tap the Playground link in the response,
    6. Test the changes in Playground—if it’s a private repo, you’ll authenticate with
       GitHub here,
    7. If it works, create a PR and merge it—you got to test before even opening the
       PR.
 * It’s a complete development loop. The AI handles the code, GitHub handles version
   control, and Playground handles testing. Your phone is just the interface tying
   it all together.
 * 
   ## Private Repositories
   
 * Until recently, this workflow only worked with public GitHub repositories. I 
   [submitted a PR to WordPress Playground](https://github.com/WordPress/wordpress-playground/pull/2856)
   that adds GitHub OAuth authentication. Now when you load a plugin from a private
   repository, Playground prompts you to authenticate, and then it works just like
   public repos.
 * 
   ## Beyond Mobile: Preconfigured Test Environments
   
 * The mobile workflow is a fun demo, but the same setup is useful on desktop too.
   The real power is in the preconfigured Playground environments through [blueprints](https://wordpress.github.io/wordpress-playground/blueprints-api/index/)(
   which you can easily create with the [Step Library](https://akirk.github.io/playground-step-library/)).
 * Say your plugin integrates with [WooCommerce](https://woocommerce.com/). You 
   can create a blueprint that installs WooCommerce, sets up a test product, and
   installs your plugin from the current branch. Now every Playground link the AI
   generates loads an environment where you can actually test the integration—not
   just whether your plugin activates without errors.
 * Or you want to test across different configurations: multisite vs single site,
   classic editor vs block editor, different PHP versions. Create a blueprint for
   each scenario, generate AI instructions for each, and you have a test matrix 
   that’s one click away.
 * 
   ## GitHub Actions
   
 * You can take this further with a [GitHub Action that posts a Playground link “Try it in Playground” as a comment on every PR](https://wordpress.github.io/wordpress-playground/guides/github-action-pr-preview).
   That way anyone reviewing the PR can test the changes without setting up a local
   environment.
 * The Step Library is available as an [npm package](https://www.npmjs.com/package/playground-step-library),
   so you can integrate it into your own tooling and CI pipelines.
 * 
   ## Let AI Create Blueprints for You
   
 * Something often overlooked: the Step Library is also useful for getting AI to
   help you create blueprints in the first place. The native Playground steps are
   low-level—things like `writeFile` and `runPHP`—so AI assistants often don’t grasp
   what’s actually possible with blueprints. The Step Library’s high-level steps
   are more intuitive, and with a [JSON schema](https://akirk.github.io/playground-step-library/step-library-schema.json)
   that describes them, AI can easily understand what’s available and generate useful
   blueprints.
 * 
   ## Other New Step Library Features
   
 * Some notable other things I added recently:
 * **[wp-env.json import](https://akirk.github.io/playground-step-library/docs/importers#wp-envjson)**:
   Drop your `.wp-env.json` into the Step Library and it converts your local dev
   environment config into a Playground blueprint.
 * **[GitLab, Bitbucket, and Codeberg support](https://akirk.github.io/playground-step-library/docs/importers#plugintheme-urls)**:
   Not everyone uses GitHub. The Step Library now recognizes repository URLs from
   these platforms.
 * **[Paste detection](https://akirk.github.io/playground-step-library/docs/importers)**:
   Paste a plugin URL, some PHP code, or even an existing Playground URL, and the
   Step Library figures out what it is and creates the right steps.
 * 
   ## Try It
   
 * The [Playground Step Library](https://akirk.github.io/playground-step-library/)
   is where you can create your blueprint and generate AI instructions.
 * I’ve found myself using this on the train, in waiting rooms, wherever I have 
   a few minutes and an idea I want to try. It’s not how I imagined WordPress development
   would work, but it does.
 * 
   ###### Fediverse Reactions
   
    -  [ ⌊Hans-Gerd Gerhards⌉ ](https://wp-social.net/@hgg)
    -  [ ⌊David Bisset⌉ ](https://phpc.social/@davidbisset)
 *  -  [ ⌊Birgit Pauli-Haack⌉ ](https://mastodon.social/@bph)
    -  [ ⌊David Bisset⌉ ](https://phpc.social/@davidbisset)
    -  [ ⌊Chuck Grimmett⌉ ](https://cagrimmett.com/likes/6a5c7af723/)
    -  [ ⌊Konstantin Obenland⌉ ](https://mastodon.social/@obenland)
 * [AI](https://alex.kirk.at/category/ai/), [Code](https://alex.kirk.at/category/code/),
   [Playground](https://alex.kirk.at/category/wordpress/playground/)
 * [playground](https://alex.kirk.at/tag/playground/), [Step Library](https://alex.kirk.at/tag/step-library/),
   [WordPress](https://alex.kirk.at/tag/wordpress/)
 * November 12, 2025
 * I’ll speak about [Telex](https://telex.automattic.ai/) and how to use Playground
   in your AI workflow at [today’s WordPress Vienna meetup](https://www.meetup.com/vienna-wordpress-meetup/events/311518999/)!
 * 
   ###### Fediverse Reactions
   
    -  [ ⌊akirktest⌉ ](https://mastodon.nl/@akirktest)
    -  [ ⌊Matthias Pfefferle⌉ ](https://mastodon.social/@pfefferle)
 *  -  [ ⌊akirktest⌉ ](https://mastodon.nl/@akirktest)
    -  [ ⌊Matthias Pfefferle⌉ ](https://mastodon.social/@pfefferle)
 * [Web](https://alex.kirk.at/category/web/)

 [Previous Page](https://alex.kirk.at/?output_format=md&term_id=44046) [Next Page](https://alex.kirk.at/page/3/?output_format=md&term_id=44046)