equipay

equiPay

Chrome extension that streamlines filing pay-transparency-law complaints. Ships with New York Pay Transparency Law (§194-b) support today, filed with the NYS Department of Labor; architected as a per-state adapter registry so other states with similar laws (CA SB 1162, CO Equal Pay for Equal Work Act, WA SHB 1795, etc.) can be added by dropping in one new adapter file.

When you see a job posting on LinkedIn (or other supported boards) that’s missing a pay range, one click:

1. Captures the full job description as a PDF (with URL, timestamp, and metadata header).
2. Opens the NYS DOL complaint form in a new tab.
3. Pre-fills your claimant info, the §194-b checkboxes, and a standard explanation.
4. Attempts to attach the PDF automatically — falls back to highlighting the file field if the form’s JSF component rejects the programmatic upload.
5. Shows a review panel with the §194-b requirements, a business-address lookup helper, and links to the statute so you can confirm before submitting.

The extension never submits the complaint itself — it only prepares it for your review.

Supported job boards

LinkedIn, Indeed, Glassdoor, ZipRecruiter, Monster, Greenhouse, Lever, Workday. A generic fallback handles unknown sites by finding the largest <article> / <main> block.

Install (developer mode)

git clone https://github.com/pandtlabs/equipay.git
cd equipay
npm install    # fetches deps, syncs vendor/, builds icons, and produces dist/formfill.js

Then:

1. Open chrome://extensions
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked → select this repo’s root directory
4. Pin equiPay in the toolbar
5. Right-click the icon → Options → enter your claimant info (name, email, phone, address) and save

Use

1. On a job posting that’s missing a pay range, click the equiPay toolbar icon.
2. A PDF downloads; a new tab opens to the NYS DOL form, pre-filled.
3. Read the review panel at the bottom-right. Confirm all four requirements apply (4+ employees, NY job, missing range, accurate claimant info).
4. Use the 🔍 NY DOS or 🌐 Web search buttons to find the employer’s business address; paste it into the Business Information section.
5. If the PDF wasn’t auto-attached, drag it from Downloads into the highlighted upload field.
6. Review everything, then submit.

Development

After npm install, the repo is loadable as-is (vendor/, icons/*.png, and dist/formfill.js are all produced by the postinstall hook).

Build commands

Command	What it does
npm run build	Runs all three build steps below in sequence (default after npm install)
npm run sync-lib	Refreshes vendor/jspdf.umd.min.js + vendor/html2canvas.min.js from node_modules/
npm run build-icons	Rasterizes icons/icon.svg → icons/icon-{16,48,128}.png via sharp
npm run build-formfill	Bundles formfill/ (ES-module source) → dist/formfill.js via esbuild (IIFE, un-minified, Chrome 120 target)

Reload flow while iterating

After editing files:

If you changed…	Run…	Then…
background.js, content.js, options.*, manifest.json, anything in vendor/	(nothing — not bundled)	chrome://extensions → equiPay → ↻, then reload any tab you want to test on
Anything in formfill/	npm run build-formfill	reload extension + reload the DOL tab
icons/icon.svg	npm run build-icons	reload extension
package.json deps	npm install (triggers sync-lib)	reload extension

Content scripts stay resident in tabs until you reload those tabs — always refresh the LinkedIn or DOL tab after reloading the extension.

Source layout

formfill/
├── index.js              orchestrator (picks adapter by window.location.host)
├── lib/                  shared DOM / input / file-upload / sanitizer / review-panel helpers
└── adapters/
    ├── index.js          host → adapter registry
    └── ny.js             declarative config for NY DOL §194-b form

Adding a new state = one new file under adapters/, one entry in adapters/index.js, one host added to manifest.json’s host_permissions. See docs/ADDING_A_STATE.md for the step-by-step playbook, or docs/claude.md for full design notes.

Release

For Chrome Web Store submission, produce a zip that contains the runtime files only — no formfill/ source, scripts/, docs/, node_modules/, or package*.json. The exact zip command + per-permission justifications + listing copy live in docs/STORE_LISTING.md.

Short version:

npm run build
zip -r equipay-0.1.0.zip \
  manifest.json \
  background.js content.js options.html options.js \
  dist/formfill.js \
  vendor/jspdf.umd.min.js vendor/html2canvas.min.js \
  icons/icon-16.png icons/icon-48.png icons/icon-128.png

Architecture

See docs/claude.md for the full design notes. TL;DR:

• Manifest V3 service worker handles clicks and routes messages.
• Capture uses html2canvas on the job-description element directly (not the viewport), after temporarily neutralizing overflow / height on scroll ancestors so the full content is in the natural document flow.
• PDF composition via jsPDF directly, with a metadata header and paginated screenshot.
• Form-fill uses a per-state adapter registry: formfill/adapters/ny.js is a pure declarative config of input names, label keywords, and review-panel copy. The orchestrator + shared helpers live in formfill/lib/. esbuild bundles it into dist/formfill.js. Adding a new state is one new adapter file.
• User profile stored in chrome.storage.local; nothing leaves your browser.

License

MIT

This site is open source. Improve this page.