JK
Projecten
JK
>LADEN // LADEN
WEERGAVE INITIALISEREN
Gebouwd en ontworpen doorJK
JK
>LADEN // PROJECT DETAILS
PARSING ARCHITECTURE, DIAGRAMS & API ENDPOINTS
Terug naar projecten
Live demoBekijk op GitHub
LaTeX CV-generator
Voltooidreacttypescriptvitetailwindgogindocker

LaTeX CV-generator

Privacybewuste CV-maker die ATS-geoptimaliseerde LaTeX-documenten produceert met modulaire sjablonen.

Probleem en oplossing

Traditionele tools slaan gevoelige data op in de cloud en genereren PDF's die ATS-systemen niet goed parsen.

Functies

  • 9 geoptimaliseerde LaTeX-sjablonen voor ATS-systemen
  • Lokale opslag in de browser voor maximale privacy
  • Live preview met real-time compilatie via Go
  • Strikte handhaving van het formaat van 1 A4-pagina
  • Export naar LaTeX-broncode en PDF

Technologiestack

TechnologieVersieDoelWaarom gekozen
React19UI frameworkLatest concurrent features, lazy loading
TypeScript~6.0Type safetyPrevents runtime errors on complex resume data model
Vite8.xBuild tool & dev serverFast HMR, native ESM, code splitting via glob imports
Tailwind CSSv4Utility-first stylingRapid UI development, consistent design tokens
Zustand5.xState managementMinimal boilerplate, built-in persist middleware
@dnd-kitcore 6, sortable 10Drag-and-dropAccessible, performant sortable lists
Go1.25+Backend runtimeFast startup, small binaries, excellent concurrency
Gin1.12HTTP frameworkHigh performance, middleware ecosystem
Tectonic0.16.9LaTeX→PDF compilerSelf-contained, no TeX distribution needed
Docker—ContainerizationReproducible builds, production parity
SQLitemodernc.org/sqlite 1.54Stats persistenceNo CGO dependency, cross-compilation
Sentry10.xError tracking & monitoringSession replay, performance monitoring, feedback widget

Architectuur

React 19 SPA

Zustand Store

localStorage

Live HTML Preview

LaTeX Generator

9 Template Engine

Gin Server

:8080

Rate Limiter

API Key Auth

Compile Handler

Tectonic

SQLite Stats

Prometheus

Grafana

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Frontend (React SPA)

  • React 19 SPA with Zustand state management
  • 9 pluggable template strategy pattern (config + preview + LaTeX generator)
  • Live A4 page simulation with zoom and pagination
  • WebSocket-based real-time compilation streaming
  • Vite 8 with code splitting via import.meta.glob

Backend (Go Microservice)

  • Go/Gin HTTP server with single concern: LaTeX compilation
  • Tectonic subprocess management with --untrusted sandboxing
  • Per-IP token bucket rate limiting (5 rps, burst 10)
  • API key authentication on compile endpoints
  • SQLite for aggregate visit/download statistics

Infrastructure

  • Docker Compose orchestration (backend + Prometheus + Grafana)
  • Multi-stage Docker builds (golang → alpine + tectonic)
  • Vercel deployment for frontend, Render for backend
  • Prometheus metrics with Grafana dashboards

Projectstructuur

backend
cmd
server
main.goGin server setup, routes, middleware
internal
compiler
handlers
middleware
websocket
frontend
src
components
editor
preview
hooks
stores
templates

API-endpoints

Go Backend (poort 8080)

MethodeRouteDoel
POST/api/compileCompile LaTeX to PDF (HTTP)
GET/api/compile/wsWebSocket compile with progress streaming
POST/api/stats/visitRecord page visit
POST/api/stats/downloadRecord PDF download
GET/api/statsGet aggregate stats
GET/api/healthHealth check (Tectonic + DB status)
GET/metricsPrometheus metrics

Databaseontwerp

stats

2 cols
keyPK
TEXT
value
INTEGER
Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

stats

KolomTypeNotities
keyPKTEXTCounter name: 'visits' or 'downloads'
valueINTEGERCounter value, default 0

Single table with 2 key-value rows. WAL mode enabled. Used only for aggregate visit/download statistics — no user data stored.

No relationships. Single table with 2 counter rows.

Belangrijkste ontwerpbeslissingen

Frontend-First Architecture

Beslissing: All resume data, editing, preview, and LaTeX generation happen in the browser

Waarom: Privacy-first: all data stays in browser with localStorage persistence

Voordelen: Zero server costs for editing, user privacy, offline-capable editing

Afwegingen: No cloud sync, no cross-device access, localStorage size limits

Tectonic for LaTeX Compilation

Beslissing: Use Tectonic instead of pdflatex or other TeX distributions

Waarom: Self-contained binary, no TeX distribution needed on the server

Voordelen: Simple Docker image, reproducible builds

Afwegingen: Slower than pdflatex for complex documents

Zustand over Redux/Context

Beslissing: Use Zustand for state management with built-in persist middleware

Waarom: Minimal boilerplate, built-in localStorage persistence

Voordelen: Simple state management, easy persistence

Afwegingen: Less ecosystem than Redux

WebSocket for Compile Streaming

Beslissing: Use WebSocket instead of HTTP polling for PDF compilation

Waarom: Real-time progress feedback improves UX during 5-60s compilation

Voordelen: User sees compilation stages (validating → writing → compiling → done)

Afwegingen: More complex than HTTP polling

Strategy Pattern for Templates

Beslissing: Each template implements a Template interface with config, Preview, and generateLatex

Waarom: Multiple visual styles with shared data model

Voordelen: Extensible, each template self-contained, lazy-loadable via import.meta.glob

Afwegingen: Code duplication across templates

SQLite for Stats Only

Beslissing: Use SQLite for aggregate visit/download counters only

Waarom: Zero-config embedded DB adequate for 2 counter rows

Voordelen: No external database dependency, simple deployment

Afwegingen: Write contention under concurrent access

Tests

None configured•0 unittests

Wat wordt getest

    Ontbrekende dekking

    • Unit tests for escapeLatex, generateLatex functions
    • Unit tests for template rendering and LaTeX generation
    • Integration tests for compile handler
    • Integration tests for WebSocket compilation flow
    • E2E tests for critical user flows (edit → preview → export)

    Belangrijkste uitdagingen

    • LaTeX compilation timeout (Tectonic can take 60+ seconds for complex documents)
    • Profile image size in request body increasing payload and compilation time
    • localStorage quota limits (~5MB) for saved resume versions
    • Multi-page PDF warning — preview is approximate, actual PDF may differ
    • Concurrent compilation on single-container deployment

    Belangrijkste lessen

    • Strategy pattern for pluggable template architecture
    • WebSocket streaming for real-time compilation progress
    • LaTeX escaping with null-byte placeholders to prevent double-escaping
    • Multi-page preview simulation with section-aware pagination
    • Frontend-first architecture trade-offs (privacy vs. no cloud sync)