Install & connect

1. Download

Grab the latest plugin .zip from docs.brandfine.co/downloads/brandfine.zip.

Until the plugin lands on the official WordPress.org plugin directory, distribution is via direct download. A self-hosted update feed is on the roadmap so existing installs will get the standard "Update available" notice in WP admin.

2. Install in WordPress

1. WP admin → Plugins → Add New → Upload Plugin
2. Pick the downloaded brandfine.zip, install, Activate

After activation a Brandfine entry appears in the WP admin sidebar (top-level item, not under Settings).

3. Grab your workspace API key

In your Brandfine workspace:

1. Workspaces → click the workspace you want to connect to this WordPress site
2. API key → Reveal, copy the key (starts with brandfine_)

The key is the credential for one workspace. If you run multiple WordPress sites pointing at different workspaces, each site uses its own key.

4. Connect

In WP admin → Brandfine → paste the key into the Workspace API key field → Connect to Brandfine.

You'll land on the connected screen, which lists which Brandfine services are active on this workspace and gives you one-click deep-links into the Brandfine dashboard to manage them.

What the connected screen shows you

Connected — WP Demo
Test dev · test-dev

Available services
✓ Forms          → Open inbox
✓ Appointments   → Open inbox  /  Activate
✓ Analytics      → Open dashboard
○ Live chat      → Coming soon

Add the booking widget to a page
[brandfine_appointments]

If a service shows as Not activated, the "Activate" link deep-links into the Brandfine plugins page with the activation modal pre-opened for that workspace.

Disconnecting

In WP admin → Brandfine → Disconnect. Removes the API key from wp_options. Shortcodes and analytics injection stop working until you reconnect with the same (or a different) key.

Local development

If you're building or debugging the plugin, see the apps/wordpress-plugin/README.md for the wp-env Docker setup and the 90-second smoke test recipe.