Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/scottjgd/boreal-relay/archive/refs/heads/main.zipBoreal Relay is the free WordPress.org edition of Borealform's BYOK AI support assistant. It includes chat, approved starter knowledge, conversation history, feedback, human escalation, and widget settings without a licence.
Public source: https://github.com/scottjgd/boreal-relay
The commercial boreal-relay-pro add-on is maintained separately and must never
be copied into this plugin or its WordPress.org ZIP.
Build the WordPress.org package
node scripts/package-wordpressorg.mjs
The packager creates .wordpressorg-dist/boreal-relay.zip plus a versioned
submission ZIP and rejects unexpected files, licence code, Pro source, external
updater hooks, Borealform licence endpoints, legacy short global identifiers,
and nested development artifacts.
Release checks
- Run PHP syntax checks across the free and Pro source.
- Build both ZIPs with their dedicated scripts.
- Run WordPress Plugin Check in strict mode against the extracted free ZIP.
- Test Free alone on a clean WordPress install.
- Test Pro inactive, valid, invalid, revoked, expired, and offline.
- Capture real WordPress screenshots for the directory listing.
- Upload only the free ZIP/source to WordPress.org.
External service boundary
Free contacts OpenAI only after the site administrator saves their own API key and a visitor uses chat. It does not contact Borealform, load remote code, perform licence checks, or use a commercial updater.