Installation

Installation

Download the plugin ZIP from the latest release and upload it through WordPress → Plugins → Add New → Upload Plugin. Instant Playground works without hosting a runtime. Instant sessions are temporary; save a checkpoint or download a ZIP before closing. For sites that reopen automatically, configure a custom runtime using Runtime hosting. To build from source instead, use the commands below.

Requires an OpenStation installation exposing native windows, shared stores, desktop files, and the cancellable native-window close hook. Initial access is restricted to administrators (manage_options).

npm ci
npm run check
npm run package

Install dist/recess-for-openstation-0.2.0.zip in WordPress and activate it alongside OpenStation. Open Recess from the dock or desktop, or use /recess.

For saved sites, use a separate Playground runtime origin with the included storage companion. Configure its URL in Connection & setup, or set an installation-wide default in wp-config.php:

define( 'RECESS_RUNTIME_URL', 'https://your-runtime.example/remote.html' );

Click Test connection to check the runtime HTML, matching client, and browser storage permission. A passing connection check is a preflight; WordPress itself is tested when a site boots. Use a dedicated origin, never the authenticated WordPress origin. An HTTPS runtime is required except on localhost. The runtime must serve its matching /client/index.js; Recess loads that module directly to preserve Playground's origin validation.