ResumeRank
ResumeRank scores every applicant against a job's actual requirements — with
quoted evidence and explicit gaps — so a recruiter can shortlist in under 60
seconds without trusting a black box. Create a job with a structured
requirement list, add candidates by pasting resume text, click Score with
AI, and get a weighted 0–100 score plus a requirement-by-requirement
breakdown: verdict, a verbatim quote from the resume, and a note explaining
the call.
ResumeRank is open source and built for many companies, not one. Register and
you get your own company workspace — your jobs, candidates, and applications,
isolated from every other company on the same instance. Invite your team by
email, and customize your company profile (logo, industry, size, location)
from Settings. Self-host it for your org, or run it as a shared instance where
each company that registers gets its own walled-off data.
Features
- Explainable AI scoring — Groq returns a strict JSON contract, parsed by
Zod, with one verdict (strong / partial / missing) per requirement, a
resume-verified evidence quote, and a note. No partial or silent writes on
malformed output.
- Weighted rubric — must-have requirements count twice as much as
nice-to-haves; a partial verdict earns half credit.
- Full applicant pipeline — jobs, candidates, and applications move
through new → screening → shortlisted → interview → offer → hired /
rejected, with soft delete and undo.
- Team scorecards — teammates leave a 1–5 rating and notes alongside the
AI's evaluation.
- Multi-tenant workspaces — every company's jobs, candidates,
applications, and activity log are scoped to that company alone; a shared
Postgres database backs any number of tenants with row-level isolation.
- Company registration — signing up creates your company and makes you
its OWNER; there's no shared or first-user-wins workspace.
- Email invites — admins/owners invite teammates by email and role
(admin / member / viewer) from Settings → Team; invitees accept at a
tokenized
/invite link. Google sign-ins with no company land on
/onboarding to accept a pending invite or create a company.
- Company settings — HR (admin/owner) edits the company profile (name,
logo, website, description, industry, size, location) from Settings →
Company; members see it read-only.
- Server-enforced RBAC — owner / admin / member / viewer roles, plus
hiring managers and interviewers who see only the jobs they're assigned to
(directly or through a department). Roles are re-checked from the database
on every request; the client role is never trusted.
- Immutable activity log — every mutation is recorded and filterable by
entity.
- Dashboard — pipeline funnel, score distribution, and application volume
over time via recharts.
- Search, filters, and CSV export — server-side, debounced, mirrored into
the URL.
Tech stack
Next.js 16.2 (App Router, Turbopack) · React 19 · TypeScript (strict) · npm
workspaces (backend / frontend) · Tailwind CSS 4 · Prisma 7 (driver adapter,
Postgres) · Auth.js v5 (JWT sessions, Google OAuth) · Groq (LLM scoring) ·
Zod 4 · Vitest · Playwright · framer-motion · GSAP + Lenis (marketing motion) ·
recharts.
Project layout
An npm-workspaces monorepo:
backend/ (@resumerank/core) — framework-agnostic domain: Prisma
schema / migrations / generated client / seed, the db and env singletons,
Zod validators, the scoring engine, auth helpers (including company invite
tokens), company slug generation, email, rate limiting, the activity log,
and shared types. No Next.js imports; ships raw TypeScript that Turbopack
transpiles.frontend/ — the Next.js App Router app: routes (including
/onboarding and /invite for joining a company, and /settings/company
for the company profile), UI, server actions and queries — every tenant-owned
one scoped to the caller's company via requireMember() — the Auth.js config
and guards, and the marketing site. Imports the backend as
@resumerank/core/*.
Run every command from the repo root — the root scripts fan out to the right
workspace, and a single root .env feeds both.
Quick start
git clone <this-repo>
cd resumerank
npm install # installs both workspaces and generates the Prisma client
# Local Postgres via Docker (port 5433). POSTGRES_DB must match DATABASE_URL.
docker run --name resumerank-pg \
-e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=resumerank \
-p 5433:5432 -d postgres:16
cp .env.example .env
# Fill in DATABASE_URL (point at the container above) and AUTH_SECRET
# (generate one with `openssl rand -base64 32` or `npx auth secret`).
npm run db:migrate
npm run db:seed
npm run dev -- -p 3005
Open http://localhost:3005. Sign in with the seeded demo account, which
lands you in the demo company "Acme Talent":
AI scoring works out of the box against seeded data; to score new
applications yourself, add a free GROQ_API_KEY (see the env table below).
Registering a new account (/register) instead creates your own company
and makes you its owner — it's fully isolated from Acme Talent and from every
other company on the same instance. Teammates don't self-register into your
company; invite them by email from Settings → Team once you're signed in.
Environment variables
Copy .env.example to .env (at the repo root — it feeds both workspaces).
Full contract and defaults live in backend/src/env.ts.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
