Skip to content

Installation

Jump to bottom
Nick Hamze edited this page Sep 8, 2026 · 2 revisions

Installation

Download the plugin ZIP from the latest release and upload it through WordPress → Plugins → Add New → Upload Plugin. The ZIP does not include the separate Playground runtime; see 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.1.0.zip in WordPress and activate it alongside OpenStation. Open Recess from the dock or desktop, or use /recess.

Recess needs a separate Playground runtime origin with the included storage companion. Configure its URL in Runtime settings, or set an installation-wide default in wp-config.php:

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

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.

Recess

Clone this wiki locally