Development

Development

Recess is a standalone plugin built on OpenStation’s app framework: native windows, controls, tabs, dock/desktop registration, commands, file openers, shared stores, activity events, tracked requests, confirmations, and the native close veto.

Clone https://github.com/regionallyfamous/recess-for-openstation.git, then run npm ci and npm run package.

• src/ contains TypeScript source; assets/recess.js is generated.
• npm test checks Blueprint validation, path boundaries, catalog isolation, writer locks, and persistence failure behavior.
• npm run typecheck validates interfaces; npm run lint checks formatting.
• scripts/smoke.mjs exercises the local Studio installation in a real browser. It obtains short-lived local authentication via studio wp, keeps auth state under ignored .cache/, and never needs a password in source.
• The local Studio site is linked to this repository, so rebuilt assets are immediately available there.

AI building, live-site cloning/staging, deployment to hosting, automatic synchronization, and collaborative editing are outside this release.

See validation notes for the tested workflows and deployment boundaries.

src/connection.ts owns runtime preflight and the hosted instant-session choice. src/packages.ts validates package ZIPs, enumerates installed WordPress packages, and exports installable archives with their root directory.