How to build a theme demo with WP Playground blueprints

[justintadlock]

Note: This topic was previously approved, but it has now been split from the existing ticket, which covers a more general overview/introduction: #198

Discussed in #196

^{Originally posted by justintadlock January 3, 2024}
One of the most painful experiences (at least in my opinion) is managing live demos to showcase your new Wordpress theme to the world. You usually need to set up and maintain a multisite instance for multiple themes. And, it becomes more complex if you want to give potential users access to the admin to actually explore it. It's a headache and management nightmare.

What if you didn't need to do all of that?

That's where WordPress Playground comes in, especially its Blueprints API: https://wordpress.github.io/wordpress-playground/blueprints-api/index

You can easily provide a demo (even multiple demos with their own configurations) by simply providing a blueprint to Playground.

My proposal is to write a guide on using Playground to showcase your theme.

We have some working examples in the current Block Theme Examples repo (click the links in the README to see how this works): https://github.com/WordPress/block-theme-examples

[bph]

notes for demo content:

• 10 posts w. featured images
• Pages with patterns
  How to handle Challenges:
• XML has wrong images.
• where to store images for content and patterns
• Hotlink to the photo library.
• Mixed content errors.

[vcanales]

Hi 👋 I've been working on automatically generating theme previews for PRs in Automattic's free themes repo, in case it helps as an example of how to implement this and the constraints it involves.

Automattic/themes#7719