Product Overview & Philosophy

LumaCV is a high-performance, open-source resume engineering platform. It pairs the Typst Rust WASM vector typesetting engine with a deterministic ATS scoring model, multi-provider AI tailoring, and client-side zero-storage privacy guarantees.

Quickstart Walkthrough

Generate an ATS-tailored, vector-typeset resume in four simple steps:

Interactive Execution Architecture

LumaCV separates heavy vector typesetting and deterministic scoring into specialized runtime layers:

4-Step Resume Studio Workflow

The resume builder UI is designed as a focused, linear 4-step wizard that ensures complete verification before export:

Authentication & Workspace Isolation

LumaCV uses server-side cookie authentication to preserve drafts, track revision histories, and prevent unauthorized access:

Typst Vector Typesetting vs Headless Chromium

Most traditional resume builders rely on headless browsers (Puppeteer, Playwright) or heavy LaTeX distributions (TeX Live). LumaCV is built around Typst, a modern, Rust-based typesetting system.

#let resume(title: "", author: (), body) = {
  set document(title: title, author: author.name)
  set page(paper: "a4", margin: (x: 1.5cm, y: 1.2cm))
  set text(font: "Liberation Sans", size: 10pt)
  body
}

Template Catalog & Architecture (52 Systems)

LumaCV provides 52 distinct Typst template systems organized into 5 professional archetypes. Explore them in the Templates Gallery:

Deterministic ATS Scoring Formula

LumaCV evaluates alignment between your resume and target job descriptions using a deterministic 4-vector algorithm defined in app/api/v1/resume/score/route.ts:

Fact-Checking & Integrity Verification

Standard AI chatbots frequently hallucinate certifications, employers, or technologies you never used. LumaCV enforces strict anti-hallucination guardrails implemented in lib/fact-validator.ts:

• Immutable Ground Truth: Extracted company names, job titles, dates of employment, and university degrees cannot be modified or invented by the AI pipeline.
• Bullet Diff Studio: In Step 4, candidates can inspect side-by-side diffs of original vs. tailored bullets and selectively revert any individual line with a single click.
• Truth Verification Algorithm: Any newly suggested bullet point that introduces ungrounded credentials not substantiated by the source document is flagged or pruned.

Data Handling & Privacy Standards

We treat candidate career histories as strictly confidential data:

REST API Reference & Endpoints

LumaCV exposes clean, documented REST route handlers for programmatic resume parsing, tailoring, scoring, and vector compilation:

curl -X POST "https://your-domain.com/api/v1/resume/parse" \
  -H "Content-Type: application/json" \
  -H "x-gemini-api-key: YOUR_GEMINI_API_KEY" \
  -d '{ ...payload }'

{
  "personalInfo": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "title": "Principal Distributed Systems Architect"
  },
  "experience": [
    {
      "company": "Tech Corp",
      "title": "Staff Engineer",
      "dates": "2021, Present",
      "bullets": [
        "Architected real-time streaming pipeline reducing event latency by 72%."
      ]
    }
  ]
}

Tech Stack & Dependency Audit

LumaCV is built with modern, battle-tested technologies selected for performance, type safety, and minimal bundle size:

Environment Variables & Configuration

Configure the following variables in your .env.local file:

Docker & Self-Hosting Guide

Run LumaCV fully isolated in your private infrastructure with pre-installed Typst binary:

version: '3.8'

services:
  lumacv:
    image: ghcr.io/sahilbnsll/lumacv:latest
    container_name: lumacv-app
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - GEMINI_API_KEY=${GEMINI_API_KEY}
      - GROQ_API_KEY=${GROQ_API_KEY}
      - NEXT_PUBLIC_SUPABASE_URL=${NEXT_PUBLIC_SUPABASE_URL}
      - NEXT_PUBLIC_SUPABASE_ANON_KEY=${NEXT_PUBLIC_SUPABASE_ANON_KEY}

docker-compose up -d

Keyboard Shortcuts Reference

Speed up your resume engineering workflow with built-in hotkeys:

Production Deployment Guide

LumaCV is optimized for one-click serverless deployment on Vercel:

• Native Typst Execution: The serverless compiler automatically provisions the platform-specific Typst binary in Node.js serverless functions.
• Timeout Buffering: Long-running AI endpoints (/api/v1/resume/parse, /api/v1/resume/tailor) are configured with maxDuration = 60.
• Edge Compatibility: Real-time keyword scoring (/api/v1/resume/score) executes in under 10ms.

Troubleshooting & Common Questions