Skip to content

README.md

Latest commit

 

History

History
58 lines (38 loc) · 1.65 KB

README.md

File metadata and controls

58 lines (38 loc) · 1.65 KB
Raw

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.