ResumeForge

A production-ready multi-tenant PDF resume generation SaaS with ATS scoring, async job processing, a Next.js dashboard, and a published TypeScript SDK.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Next.js    │────▶│  Express API │────▶│   MongoDB    │
│  Dashboard   │     │  (Port 4000) │     │              │
└──────────────┘     └──────┬───────┘     └──────────────┘
                            │
                     ┌──────▼───────┐
                     │   Inngest    │
                     │ (Async Jobs) │
                     └──────┬───────┘
                            │
              ┌─────────────┼─────────────┐
              ▼             ▼             ▼
        ┌──────────┐ ┌──────────┐ ┌──────────┐
        │Puppeteer │ │Cloudinary│ │  Email   │
        │(PDF Gen) │ │(Storage) │ │ (SMTP)  │
        └──────────┘ └──────────┘ └──────────┘

• Multi-tenant — project-based isolation with API keys
• PDF Generation — Handlebars templates → Puppeteer → PDF
• ATS Scoring — automated resume quality scoring (skills, experience, summary, structure)
• Async Processing — Inngest-powered background jobs with status tracking
• Bulk Generation — batch generate hundreds of PDFs in one request
• Resilient Storage — Cloudinary with automatic local fallback
• Email Notifications — SMTP notifications when PDFs are ready
• Webhooks — POST notifications on job completion
• Dashboard — full Next.js admin UI with org switching, filtering, search
• SDK — published TypeScript SDK (@exwhyzed/pdflet) with retries, timeouts, and typed errors
• Docker-ready — multi-stage Dockerfile included

• Node.js 20+
• MongoDB (local or Atlas)
• Inngest CLI (for async job processing)

git clone https://github.com/exwhyzed/pdf-template.git
cd pdf-template
npm install

cp .env.example .env

Edit .env with your values:

# Required
MONGODB_URI=mongodb://localhost:27017/pdf-template
PORT=4000

# Optional — Cloudinary (falls back to local storage)
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

# Optional — Email notifications
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=your_email@example.com
SMTP_PASS=your_password

# Optional — Inngest
INNGEST_EVENT_KEY=your_event_key
INNGEST_SIGNING_KEY=your_signing_key

# Terminal 1 — Backend API
npm run dev

# Terminal 2 — Inngest Dev Server
npx inngest-cli@latest dev -u http://localhost:4000/api/inngest

# Terminal 3 — Frontend Dashboard
cd web && npm install && npm run dev

The API runs at http://localhost:4000 and the dashboard at http://localhost:3000.

On first start, a default project and API key are auto-seeded and written to .dashboard-key and web/.env.local.

pdf-template/
├── src/                    # Backend (Express + TypeScript)
│   ├── api/
│   │   ├── controllers/    # Route handlers
│   │   └── routes/         # API route definitions
│   ├── config/             # DB connection config
│   ├── inngest/            # Async job functions (PDF gen, ATS scoring)
│   ├── middleware/          # API key auth, error handler, rate limiter
│   ├── models/             # Mongoose schemas (Project, Job, Template, User, Analytics)
│   ├── seeds/              # Auto-seed default project on startup
│   ├── services/           # Business logic (PDF, storage, email, ATS)
│   ├── templates/          # Handlebars resume templates (.hbs)
│   └── server.ts           # Entry point
├── web/                    # Frontend (Next.js 15 + Tailwind)
│   └── src/
│       ├── app/            # Pages: Dashboard, Jobs, Resumes, Templates, Generate, Settings
│       ├── components/     # Sidebar, layout
│       └── lib/            # API client
├── sdk/                    # Published npm SDK (@exwhyzed/pdflet)
│   ├── src/index.ts        # SDK source
│   ├── package.json
│   └── README.md
├── Dockerfile              # Multi-stage production build
└── .env.example

All endpoints are prefixed with /v1. Authenticated routes require the x-api-key header.

Generate PDF:

curl -X POST http://localhost:4000/v1/generate/default-resume \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_your_key" \
  -d '{
    "resumeData": {
      "name": "Jane Doe",
      "email": "jane@example.com",
      "skills": ["TypeScript", "React"]
    }
  }'

Install the official TypeScript SDK:

npm install @exwhyzed/pdflet

import { createClient } from '@exwhyzed/pdflet';

const client = createClient({
  apiKey: 'pk_your_key',
  baseUrl: 'https://api.resumeforge.dev',
  retry: { maxRetries: 3 },
  debug: true,
});

const { jobId } = await client.generatePDF('default-resume', {
  name: 'Jane Doe',
  skills: ['TypeScript', 'React'],
});

const job = await client.waitForJob(jobId);
console.log(job.pdfUrl, job.atsScore);

SDK Features: retry with exponential backoff, request timeouts, rate-limit awareness, input validation, debug logging, typed errors (PdfletError, TimeoutError, RateLimitError, ValidationError).

See sdk/README.md for full documentation.

The Next.js dashboard provides:

• Dashboard — overview with job stats, recent activity, project info
• Jobs — real-time job list with status badges, ATS score breakdown, auto-refresh
• Resumes — completed PDFs with embedded previews, search, filtering by template/ATS score
• Templates — browse, create, and manage Handlebars resume templates
• Generate — interactive PDF generation form with template selection
• Settings — organization management, API keys, webhook config, usage/billing
• Org Switcher — switch between organizations directly from the sidebar

Resume templates use Handlebars syntax. Built-in templates:

Create custom templates via the API or dashboard with HTML + CSS + Handlebars variables.

Configure a webhook URL in project settings to receive POST notifications when PDFs complete:

{
  "jobId": "abc123",
  "status": "completed",
  "pdfUrl": "https://res.cloudinary.com/.../resume.pdf",
  "atsScore": { "total": 82, "breakdown": { "skills": 90, "experience": 75, "summary": 80, "structure": 85 } }
}

docker build -t resumeforge .
docker run -p 4000:4000 \
  -e MONGODB_URI=mongodb://host.docker.internal:27017/pdf-template \
  -e NODE_ENV=production \
  resumeforge

MIT