RecruiterOS Chrome Extension

Import LinkedIn candidates into TalentSearch via the RecruiterOS backend.

Setup

npm install

Copy .env.development and set your API URL:

VITE_API_BASE=http://localhost:3000

For production builds, create .env.production:

VITE_API_BASE=https://your-production-domain.com

Also add your production API origin via VITE_API_BASE — it is injected into host_permissions at build time. LinkedIn host access is included for profile import.

Build

npm run build

Load the unpacked extension from the dist folder at chrome://extensions.

Click the RecruiterOS toolbar icon while on a LinkedIn profile to open the side panel (Chrome 114+).

Backend prerequisites

Before the extension works:

1. Add Supabase redirect URL: http://localhost:3000/extension/auth/callback
2. Register the extension redirect URI from chrome.identity.getRedirectURL('auth/callback') in your OAuth allowlist
3. Optionally set EXTENSION_ALLOWED_ORIGINS=chrome-extension://YOUR_EXTENSION_ID in production

Usage

1. Sign in with Google via the branded RecruiterOS login page
2. Open a LinkedIn profile (/in/...)
3. Click Import Candidate in the extension popup
4. Review extracted fields, optionally assign a team + job
5. Save — on duplicate, confirm Update candidate

Architecture

• Side panel — UI only; sends messages to the background worker
• Background service worker — PKCE auth, token refresh, all API calls
• executeScript — one-shot read of LinkedIn DOM → markdown on user click

Tokens are stored in chrome.storage.local and never exposed to LinkedIn.