Production-Grade Recruitment Platform — Hire Better, Faster, Smarter
Features · Architecture · Engineering Excellence · Tech Stack · Getting Started
WorkForge is a production-grade recruitment platform built to be deployed, measured, and scaled — with email OTP authentication, Redis-backed rate limiting, payment integrations, comprehensive observability, and an entire battery of load, E2E, and performance audits baked in. Not a demo — a delivered system.
- Job Posting & Management — create, publish, and manage job listings
- Candidate Pipeline — applications, status tracking, and hiring workflows
- Role-Based Access — separate experiences for recruiters and applicants
- Profile Management — resumes, skills, and candidate visibility
- Email OTP Authentication — passwordless sign-in via SMTP (Nodemailer)
- JWT Sessions — secure, signed session tokens
- Redis Rate Limiting — Upstash-backed throttling on auth routes
- Zod Validation — every input validated end-to-end
- Razorpay Payments — job posting / premium features checkout flow
- Cloudinary Media — resume & image uploads with CDN delivery
- Sentry — error tracking across client & server
- PostHog — product analytics and event pipelines
- Vercel Analytics — web vitals monitoring
- Cloud Backups — PostgreSQL with Prisma 7 (pg adapter)
flowchart LR
A[Next.js 16 App Router] --> B[API Routes / Server Actions]
B --> C{Request Guard}
C -->|Rate Limit| D[Upstash Redis]
C --> E[Prisma Client]
E --> F[(PostgreSQL)]
B --> G[Razorpay]
B --> H[Cloudinary]
B --> I[Nodemailer OTP]
A --> J[Sentry]
A --> K[PostHog]
src/
├── app/ # App Router pages & layouts
├── components/ # UI (Radix + Tailwind + CVA)
├── lib/ # Prisma, auth, payments, mail
├── server/ # Server actions & API logic
└── types/ # Shared TypeScript contracts
WorkForge ships with a full audit trail — every claim is backed by a report in this repo:
| Area | Report | Highlights |
|---|---|---|
| 🔬 Architecture | ARCHITECTURE_AUDIT.md |
Clean separation, typed contracts |
| 🧪 Tests | PLAYWRIGHT_RC.md · BUILD_VERIFICATION.md |
E2E + build verification |
| 🚀 Performance | LIGHTHOUSE_REPORT.md · PERFORMANCE_REPORT.md |
Lighthouse RC green |
| 📊 Load | K6_REPORT.md · LOAD_TEST_REPORT.md |
k6 load-tested |
| 🗄️ Database | DATABASE_AUDIT.md · DATABASE_VALIDATION_REPORT.md |
Schema validated |
| 📡 Observability | OBSERVABILITY.md · MONITORING.md |
Sentry + PostHog wired |
| 🚢 Deployment | DEPLOYMENT_CERTIFICATE.md · DEPLOYMENT_GUIDE.md |
Certified launch |
| ✅ Production | FINAL_PRODUCTION_AUDIT.md · LAUNCH_CHECKLIST.md |
Launch-ready |
| Layer | Technology |
|---|---|
| Framework | Next.js 16.2 · React 19 |
| Language | TypeScript (strict) + Zod |
| Database | PostgreSQL · Prisma 7 |
| Cache / Rate Limit | Upstash Redis |
| Auth | Email OTP (Nodemailer) + JWT |
| Payments | Razorpay |
| Media | Cloudinary |
| UI | Radix UI · Tailwind CSS · CVA |
| Error Tracking | Sentry |
| Analytics | PostHog · Vercel Analytics |
| Testing | Playwright · Vitest · k6 |
- Node.js 20+
- PostgreSQL database
- Redis (Upstash) instance
# 1. Clone & install
git clone https://github.com/Manthan-13521/WorkForge-Recruitment-Platform.git
cd WorkForge-Recruitment-Platform
npm install
# 2. Configure environment
cp .env.example .env.local
# → add DATABASE_URL, UPSTASH_REDIS_REST_URL,
# RAZORPAY keys, SMTP creds, etc.
# 3. Migrate the database
npx prisma migrate dev
# 4. Run the platform
npm run devnpm run lint # ESLint
npm run typecheck # TypeScript strict
npm run test # Vitest unit tests
npm run build # Production build- AI resume screening & skill matching
- Video interviews & scheduling
- Interview scorecards & feedback loops
- Recruiter analytics dashboard
- Company pages & employer branding
This is an actively audited production codebase — please read CONTRIBUTING guidance and open an issue before large changes.
All rights reserved.