Manual Install

Manual installation is intended for development, QA, or small pilots only. For organization-wide rollout, use the Google Workspace, Microsoft Intune, or Jamf deployment paths instead.

Install from a .crx file

1. Obtain the packaged .crx from your internal distribution channel (e.g. clarity-0.1.1.crx from the shared build artifacts).
2. Open chrome://extensions in Chrome or Edge.
3. Enable Developer mode (toggle in the top-right corner).
4. Drag and drop the .crx file onto the extensions page. Chrome will prompt you to confirm — click Add extension.

Install as an unpacked build

1. Run npm run build inside the extension/ directory to produce .output/chrome-mv3/.
2. Open chrome://extensions and enable Developer mode.
3. Click Load unpacked and select the .output/chrome-mv3/ directory.

Enroll manually via the options page

After installing, the extension starts in an unenrolled state. To connect it to a Robost server:

1. Click the puzzle icon in the Chrome toolbar and select Robost (pin it first if it isn’t visible).
2. On the options page, fill in:
   • Server URL — the URL of your Robost API endpoint (your admin team will provide this)
   • Enrollment token — the device token generated via the Robost API (POST /settings/devices) or provided by Robost support
3. Click Save & enroll. The credentials are stored under the key clarity-enrollment in chrome.storage.local.
4. Reload the extension (click the circular arrow on chrome://extensions) so the background service worker picks up the new credentials.

Verify the extension is active

On the options page, the Status section should show Enrolled: Yes and display the server URL. If it still shows No, reload the extension and re-open the options page.