diff --git a/docs/design/spec-v2.md b/docs/design/spec-v2.md
index d0465e4..81e4989 100644
--- a/docs/design/spec-v2.md
+++ b/docs/design/spec-v2.md
@@ -17,11 +17,13 @@
| `specs/v2/spec-v2-router-v8.md` | React Router v7 → v8 | ✅ Done |
## Overview
-v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`:
+v2 bao gồm 7 tính năng, mỗi tính năng có spec riêng trong `specs/`:
| File | Feature | Priority | Est. | Status |
|------|---------|----------|------|--------|
-| `specs/v2/spec-v2-resume.md` | Resume download | P1 | ~15 min | ✅ Done |
+| `specs/v2/spec-v2-resume.md` | Resume download (UI) | P1 | ~15 min | ✅ Done |
+| `specs/v2/pdf-resume/spec-v2-resume-playwright.md` | Resume PDF (Playwright) | P1 | ~4 hours | |
+| `specs/v2/pdf-resume/spec-v2-resume-puppeteer.md` | Resume PDF (Puppeteer) | P1 | ~4 hours | |
| `specs/v2/spec-v2-hero-carousel.md` | Hero visual carousel | P1 | ~1 hour | |
| `specs/v2/spec-v2-seo.md` | SEO (metadata, OG, sitemap) | P1 | ~1 hour | |
| `specs/v2/spec-v2-blog.md` | Blog (MDX, articles, syntax highlight) | P1 | ~4 hours | |
@@ -29,7 +31,7 @@ v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`:
| `specs/v2/spec-v2-testing.md` | Testing (Vitest + E2E) | P5 | ~3 hours | |
| `specs/v2/spec-v2-cicd.md` | CI/CD (GitHub Actions) | P5 | ~1 hour | |
-**Implementation order:** ~~Resume~~ → Hero Carousel → SEO → Blog → Analytics → Testing → CI/CD
+**Implementation order:** ~~Resume~~ → ~~Resume PDF (choose one)~~ → Hero Carousel → SEO → Blog → Analytics → Testing → CI/CD
---
@@ -40,7 +42,6 @@ v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`:
- Interactive diagrams / simulations (Phase 5+)
- Search functionality (Phase 5+)
- Contact form with backend (Phase 5+)
-- Resume PDF generation (user uploads manually)
---
diff --git a/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md b/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md
new file mode 100644
index 0000000..d1c45e9
--- /dev/null
+++ b/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md
@@ -0,0 +1,988 @@
+# Specification — v2 Resume PDF (Playwright)
+
+> **Document:** `spec-v2-resume-playwright.md`
+> **Version:** 0.4.1
+
+---
+
+## Requirement
+
+- Generate `resume.pdf` (A4, multi-page, embedded fonts) during build
+- Deployed at `/resume.pdf` (root of `/dist`)
+- Download button in Hero CTA and Contact section (already implemented in `spec-v2-resume.md`)
+- PDF content: Header (with profile photo), Experience, Skills, Projects (all)
+
+---
+
+## Phases
+
+### Phase 1: Local Generation (Dev Testing)
+
+Mục tiêu: Developer có thể generate PDF locally để test layout, content, pagination trước khi push lên CI.
+
+**Scope**:
+
+- Tạo `scripts/generate-resume.ts` + `public/resume-template.html` + fonts
+- Install `playwright`, `tsx` as `devDependency`
+- Manual command: `pnpm tsx scripts/generate-resume.ts` → `dist/resume.pdf`
+- **KHÔNG** thêm vào `pnpm build` script
+- **KHÔNG** Gitea workflow changes
+
+**Workflow**:
+
+```
+git checkout -b feature/resume-pdf
+# implement Phase 1
+pnpm tsx scripts/generate-resume.ts # test locally
+# verify PDF, iterate
+git push && PR
+```
+
+### Phase 2: Gitea Workflow Integration
+
+Mục tiêu: PDF tự generate trong CI, deploy cùng site.
+
+**Scope**:
+
+- Split `deploy.yml` thành 3 jobs (build / generate-resume / deploy)
+- CI cache cho Playwright browser
+- Thêm `tsx scripts/generate-resume.ts` vào build pipeline
+- Artifact management cho PDF
+
+**Workflow**:
+
+```
+git checkout master # sau khi Phase 1 merged
+# implement Phase 2
+# push → CI tự generate + deploy PDF
+```
+
+---
+
+## PDF Structure
+
+### Page 1: Header + Start of Experience
+
+```
+┌──────────────────────────────────────────┐
+│ [Photo] Dong Nguyen │
+│ Senior Software Engineer │
+│ your.email@example.com │
+│ github.com/... │
+│ linkedin.com/... │
+├──────────────────────────────────────────┤
+│ EXPERIENCE │
+│ │
+│ Senior Software Engineer │
+│ Current Company | 2021 – Present │
+│ Ho Chi Minh City, Vietnam │
+│ │
+│ • System ownership và architecture... │
+│ • Developed IoT-DWS integration... │
+│ • Led system maintenance... │
+│ • Applied Computer Vision... │
+│ • Scrum Master responsibilities... │
+│ │
+│ IoT-DWS Integration System │
+│ Context: Tiếp nhận và nhanh chóng... │
+│ Technical: HTTP integration, HMAC... │
+│ Impact: Giải pháp DWS integration... │
+│ Metrics: 16 sortations deployed │
+│ Tech: Java, HTTP, HMAC, RocketMQ, DWS │
+└──────────────────────────────────────────┘
+```
+
+### Page 2+: Remaining Content
+
+- AWB Detection (if fits with IoT-DWS, else new page)
+- System Maintenance (if fits, else new page)
+- Skills section (always starts on new page)
+- Projects section (each project starts on new page)
+
+### Section Break Rules
+
+- **Experience** section starts on a new page (after header)
+- **Skills** section starts on a new page
+- **Each Project** starts on a new page
+- Experience achievements may flow across pages naturally if space permits
+
+---
+
+## Technology
+
+### Library
+
+```
+playwright@^1.64.0 # Playwright (Chromium)
+tsx@^4.19.0 # TypeScript executor (handles .ts imports in Node)
+```
+
+- `playwright` full install (includes browser binary ~100MB)
+- `tsx` — lightweight TS executor for Node (no install overhead)
+- Installed as `devDependency`
+- Browser downloaded once, cached in `node_modules/.cache/playwright`
+
+### Build Machine
+
+- Gitea runner: `ubuntu-latest` — cần `npx playwright install-deps chromium` cho system dependencies
+- Local dev: `npx playwright install chromium` (one-time)
+### Font Embedding
+
+- Font: **Inter** (self-hosted WOFF2) — clean, professional, good Vietnamese support
+- Embed via `@font-face` with **base64-encoded WOFF2 inline in HTML** (not relative paths — file:// URLs fail in Playwright PDF)
+- Fallback: `system-ui, -apple-system, sans-serif`
+
+---
+
+## File Structure
+
+```
+scripts/
+ generate-resume.ts # Main build script (TS, executed via tsx)
+public/
+ resume-template.html # HTML template (with {{placeholders}})
+ fonts/
+ Inter-Regular.woff2
+ Inter-Medium.woff2
+ Inter-SemiBold.woff2
+ Inter-Bold.woff2
+ profile-photo.webp
+```
+
+---
+
+## Implementation
+
+### 1. Font Setup
+
+Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold) from Google Fonts.
+Place in `public/fonts/` directory. Script reads each file, base64-encodes it, and injects `@font-face` CSS inline into the HTML template.
+
+**Commit font files into repo** (~50KB total). Do NOT add to `.gitignore`.
+
+```
+public/fonts/
+ Inter-Regular.woff2
+ Inter-Medium.woff2
+ Inter-SemiBold.woff2
+ Inter-Bold.woff2
+```
+
+Script generates this CSS at build time:
+
+```css
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 400;
+ font-display: swap;
+ src: url('data:font/woff2;base64,{{FONT_REGULAR_BASE64}}') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 500;
+ font-display: swap;
+ src: url('data:font/woff2;base64,{{FONT_MEDIUM_BASE64}}') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 600;
+ font-display: swap;
+ src: url('data:font/woff2;base64,{{FONT_SEMIBOLD_BASE64}}') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 700;
+ font-display: swap;
+ src: url('data:font/woff2;base64,{{FONT_BOLD_BASE64}}') format('woff2');
+}
+```
+
+### 2. HTML Template
+
+`public/resume-template.html` — static template with `{{placeholder}}` tokens:
+
+```html
+
+
+
+
+ Resume - Dong Nguyen
+
+
+
+
+
+
+
+
+
Experience
+ {{EXPERIENCE}}
+
+
+
+
+
Skills
+
+ {{SKILLS}}
+
+
+
+
+
+
Projects
+ {{PROJECTS}}
+
+
+
+```
+
+### 3. Build Script
+
+`scripts/generate-resume.ts` — executed via `tsx`:
+
+```typescript
+import { chromium } from 'playwright';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+const ROOT = resolve(import.meta.dirname, '..');
+
+// --- Validate required files ---
+const requiredFiles = [
+ 'public/profile-photo.webp',
+ 'public/fonts/Inter-Regular.woff2',
+ 'public/fonts/Inter-Medium.woff2',
+ 'public/fonts/Inter-SemiBold.woff2',
+ 'public/fonts/Inter-Bold.woff2',
+ 'public/resume-template.html',
+];
+
+for (const file of requiredFiles) {
+ if (!existsSync(join(ROOT, file))) {
+ console.error(`❌ Missing required file: ${file}`);
+ process.exit(1);
+ }
+}
+
+// --- Load data (tsx handles .ts imports natively) ---
+const { profile } = await import(join(ROOT, 'src/data/profile.ts'));
+const { experiences } = await import(join(ROOT, 'src/data/experience.ts'));
+const { skillGroups } = await import(join(ROOT, 'src/data/skills.ts'));
+const { projects } = await import(join(ROOT, 'src/data/projects.ts'));
+
+
+// --- Read template ---
+const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8');
+
+// --- Read and base64-encode assets ---
+const photoBase64 = readFileSync(join(ROOT, 'public/profile-photo.webp')).toString('base64');
+
+const fonts: Record = {};
+for (const [name, weight] of [
+ ['REGULAR', 'Inter-Regular.woff2'],
+ ['MEDIUM', 'Inter-Medium.woff2'],
+ ['SEMIBOLD', 'Inter-SemiBold.woff2'],
+ ['BOLD', 'Inter-Bold.woff2'],
+] as const) {
+ fonts[name] = readFileSync(join(ROOT, 'public/fonts', weight)).toString('base64');
+}
+
+// --- Generate font-face CSS ---
+const fontFaces = Object.entries(fonts).map(([key, b64]) => {
+ const weightMap: Record = { REGULAR: 400, MEDIUM: 500, SEMIBOLD: 600, BOLD: 700 };
+ return `@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: ${weightMap[key]};
+ font-display: swap;
+ src: url('data:font/woff2;base64,${b64}') format('woff2');
+}`;
+}).join('\n');
+
+// --- Render HTML helpers ---
+function renderExperience(exps: Awaited): string {
+ return exps.map(exp => `
+
+
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''}
+
+ ${exp.responsibilities.map(r => `- ${r}
`).join('')}
+
+ ${exp.achievements?.map(ach => `
+
+
${ach.title}
+
${ach.context}
+ ${ach.technicalWork?.length ? `
+
+ ${ach.technicalWork.map(t => `- ${t}
`).join('')}
+
+ ` : ''}
+
+ ${ach.technologies.map(t => `${t}`).join('')}
+
+ ${ach.impact ? `
${ach.impact}
` : ''}
+ ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''}
+
+ `).join('')}
+
+ `).join('');
+}
+
+function renderSkills(groups: Awaited): string {
+ return groups.map(group => `
+
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join('');
+}
+
+function renderProjects(projs: Awaited): string {
+ return projs.map(project => `
+
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')}
+
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''}
+
+ `).join('');
+}
+
+// --- Assemble HTML ---
+const html = template
+ .replace('{{NAME}}', profile.name)
+ .replace('{{TITLE}}', profile.title)
+ .replace('{{EMAIL}}', profile.email)
+ .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/'))
+ .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/'))
+ .replace('{{PHOTO_BASE64}}', photoBase64)
+ .replace('{{FONT_FACES}}', fontFaces)
+ .replace('{{EXPERIENCE}}', renderExperience(experiences))
+ .replace('{{SKILLS}}', renderSkills(skillGroups))
+ .replace('{{PROJECTS}}', renderProjects(projects));
+
+// --- Generate PDF ---
+const browser = await chromium.launch();
+const page = await browser.newPage();
+await page.setContent(html); // No waitUntil needed — all resources inline
+
+const outputPath = join(ROOT, 'dist/resume.pdf');
+await page.pdf({
+ path: outputPath,
+ format: 'A4',
+ printBackground: true,
+ // margin inherited from @page CSS
+
+await browser.close();
+console.log(`resume.pdf generated at ${outputPath}`);
+```
+
+### 4. package.json
+
+**Phase 1** (local dev only):
+
+```json
+{
+ "scripts": {
+ "build": "tsc -b && vite build"
+ },
+ "devDependencies": {
+ "playwright": "^1.64.0",
+ "tsx": "^4.19.0"
+ }
+}
+```
+
+Build script **không** chạy PDF generation. Developer chạy manual:
+
+```bash
+pnpm tsx scripts/generate-resume.ts
+```
+
+**Phase 2** (CI integration):
+
+```json
+{
+ "scripts": {
+ "build": "tsc -b && vite build && tsx scripts/generate-resume.ts"
+ }
+}
+```
+
+### Data Detection
+
+`src/data/resume.ts` — controls whether download button is visible in UI:
+
+```ts
+// src/data/resume.ts
+export const resumeAvailable = true // set false when PDF not yet deployed
+```
+
+**Phase 1 (dev):** Hardcoded boolean. Developer sets `false` locally until PDF is ready,
+sets `true` after deployment to verify the button appears.
+
+**Phase 2 (CI):** After CI generates and deploys `dist/resume.pdf`, the button
+will show because `/resume.pdf` exists on the server.
+
+> ⚠️ Do NOT use `existsSync` — this file is bundled by Vite for the browser.
+> Node.js `fs` APIs are unavailable in browser runtime.
+
+---
+
+## Acceptance Criteria
+
+### Phase 1
+
+- [ ] `pnpm tsx scripts/generate-resume.ts` produces `dist/resume.pdf`
+- [ ] PDF is A4 size, multi-page with correct pagination
+- [ ] Header contains profile photo (circular crop), name, title, contact info
+- [ ] Experience section includes all companies, roles, responsibilities, achievements (with technicalWork bullets)
+- [ ] Skills section includes all skill groups
+- [ ] All projects included (not just featured)
+- [ ] Sections do not split across pages (achievements, projects, skill groups use `page-break-inside: avoid`)
+- [ ] Experience section starts on a new page after header
+- [ ] Skills section starts on a new page
+- [ ] Each project starts on a new page
+- [ ] Fonts are embedded (Inter, 4 weights, base64 inline)
+- [ ] PDF is readable and well-formatted (no overflow, text not cut off)
+- [ ] Works locally on Windows dev machine
+- [ ] `pnpm build` still works (no PDF in build output)
+- [ ] Script exits with error if required files are missing
+
+### Phase 2
+
+- [ ] `pnpm build` produces `dist/resume.pdf` (auto-generated)
+- [ ] Works in Gitea CI (`ubuntu-latest`)
+- [ ] CI cache reduces Playwright install to 0s after first run
+- [ ] Download button shows in Hero and Contact sections
+- [ ] PDF deployed to `/resume.pdf` (root of `/dist`)
+
+---
+
+## Tradeoffs
+
+### Phase 1
+
+| Aspect | Detail |
+|--------|--------|
+| Install overhead | ~110MB (playwright + tsx) |
+| Manual command | `pnpm tsx scripts/generate-resume.ts` |
+| Build time | Not in `pnpm build` — developer controlled |
+| CSS control | Full CSS (same as website) |
+| Font embedding | Base64 in HTML, increases HTML size ~50KB |
+| Photo | Inline base64 (avoids file:// URL issues) |
+| Platform | Works on Windows local, Ubuntu CI |
+
+### Phase 2
+
+| Aspect | Detail |
+|--------|--------|
+| CI build time | +5-10s (download once cached, render ~2s) |
+| CI first run | +60s (download Playwright browser) |
+| CI subsequent | +5-10s (cache hit) |
+| Workflow complexity | 3 jobs (build / generate-resume / deploy) |
+| Failure isolation | PDF error does not block site deploy |
+
+---
+
+## Future Enhancements
+
+### Phase 2+: Gitea Workflow
+**Current** (`deploy.yml` — Phase 1):
+
+```yaml
+name: Deploy Static Site
+
+on:
+ push:
+ branches: [master]
+
+jobs:
+ build and deploy:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v7
+ - uses: pnpm/setup@v3
+ with:
+ cache: true
+ version: ^12.0.0
+ runtime: node@24
+ - run: pnpm build
+ - name: rsync deployments
+ uses: burnett01/rsync-deployments@v9
+ with:
+ debug: true
+ switches: -avzr --delete
+ path: dist/
+ remote_path: /opt/stacks/dong-site/dist/
+ remote_host: ${{ secrets.DEPLOY_HOST }}
+ remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
+ remote_user: ${{ secrets.DEPLOY_USER }}
+ remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
+```
+
+**Phase 2** (3 jobs split):
+
+```yaml
+name: Deploy Static Site
+
+on:
+ push:
+ branches: [master]
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v7
+ - uses: pnpm/setup@v3
+ with:
+ cache: true
+ version: ^12.0.0
+ runtime: node@24
+ - run: pnpm build # tsc -b && vite build (không có PDF)
+ - uses: actions/upload-artifact@v4
+ with:
+ name: static-site
+ path: dist/
+ retention-days: 5
+
+ generate-resume:
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - uses: actions/checkout@v7
+ - uses: pnpm/setup@v3
+ with:
+ cache: true
+ version: ^12.0.0
+ runtime: node@24
+
+ # Cache Playwright browser — download 1 lần, reuse các lần sau
+ - name: Cache Playwright browser
+ uses: actions/cache@v4
+ with:
+ path: ~/.cache/ms-playwright
+ key: playwright-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}
+ restore-keys: |
+ playwright-${{ runner.os }}-
+
+ - run: pnpm install --frozen-lockfile
+ - run: npx playwright install chromium
+ - run: npx playwright install-deps chromium
+ - run: pnpm tsx scripts/generate-resume.ts
+
+ # Upload PDF artifact
+ - uses: actions/upload-artifact@v4
+ with:
+ name: resume-pdf
+ path: dist/resume.pdf
+ retention-days: 30
+
+ deploy:
+ runs-on: ubuntu-latest
+ needs: [build, generate-resume]
+ steps:
+ - uses: actions/download-artifact@v4
+ with:
+ name: static-site
+ path: dist/
+
+ - uses: actions/download-artifact@v4
+ with:
+ name: resume-pdf
+ path: dist/
+
+ - name: rsync deployments
+ uses: burnett01/rsync-deployments@v9
+ with:
+ debug: true
+ switches: -avzr --delete
+ path: dist/
+ remote_path: /opt/stacks/dong-site/dist/
+ remote_host: ${{ secrets.DEPLOY_HOST }}
+ remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
+ remote_user: ${{ secrets.DEPLOY_USER }}
+ remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}
+```
+
+**Job dependency graph**:
+
+```
+build ──────────────┐
+ ├──→ deploy
+generate-resume ────┘
+```
+
+**Key decisions**:
+
+- `generate-resume` depends on `build` (chỉ cần checkout, không cần artifact)
+- `deploy` depends on cả 2 jobs — đảm bảo cả site + PDF sẵn sàng
+- Artifact retention: site 5 ngày, PDF 30 ngày
+- Cache key dựa trên `pnpm-lock.yaml` — invalidate khi dependency thay đổi
+- `npx playwright install chromium` — install vào `~/.cache/ms-playwright` (khác với `node_modules/.cache`)
+- `dist/` từ artifact overwrite lẫn nhau — `resume.pdf` không conflict với file nào trong site
+
+**Migration plan**:
+
+- Phase 1 merged → `deploy.yml` unchanged
+- Phase 2: replace `deploy.yml` với 3-job version
+- Update `package.json` scripts thêm `tsx scripts/generate-resume.ts`
+- First CI run: +60s (download browser), subsequent: +5-10s (cache hit)
+- Monitor: check `dist/` trên server có `resume.pdf` sau deploy
+
+
+### PDF Metadata
+
+Đặt metadata trong `page.pdf()` options:
+
+```typescript
+await page.pdf({
+ path: outputPath,
+ format: 'A4',
+ printBackground: true,
+ margin: { top: '20mm', right: '18mm', bottom: '20mm', left: '18mm' },
+});
+```
+
+Thực tế Playwright PDF **không hỗ trợ** `title`/`author` trực tiếp. Alternative:
+- Inject `` tags trong HTML (chỉ hiển thị trong browser print dialog)
+- Dùng `pdf-lib` sau khi generate để set metadata (thêm dependency)
+
+**Recommendation**: Bỏ qua metadata — resume PDF không cần metadata chuyên nghiệp.
+
+### Version Stamping
+
+Thêm footer "Last updated: YYYY-MM-DD" vào mỗi trang PDF.
+
+**Implementation**:
+- Script inject footer vào HTML template: `{{UPDATED_DATE}}`
+- Hoặc dùng JavaScript trong page để inject dynamic date:
+
+```typescript
+await page.evaluate((date: string) => {
+ const footer = document.createElement('div');
+ footer.className = 'pdf-footer';
+ footer.textContent = `Last updated: ${date}`;
+ document.body.appendChild(footer);
+}, new Date().toISOString().slice(0, 10));
+```
+
+**CSS**:
+```css
+.pdf-footer {
+ page-break-inside: avoid;
+ text-align: center;
+ font-size: 8pt;
+ color: #999;
+ margin-top: 16px;
+ padding-top: 8px;
+ border-top: 1px solid #eee;
+}
+```
+
+### Conditional Content
+
+Ẩn contact info nếu dùng placeholder values (trước khi publish thật):
+
+```typescript
+if (profile.email === 'your.email@example.com') {
+ console.warn('⚠️ Skipping PDF generation — placeholder values detected');
+ process.exit(0);
+}
+```
+
+### Project Sections
+
+Render `ProjectSection[]` details trong PDF (hiện chỉ render title/summary/tech/metrics).
+
+Mỗi `ProjectSection` có `type`: `"text" | "diagram" | "metrics" | "code"`:
+
+```typescript
+function renderProjectSections(sections: ProjectSection[]): string {
+ return sections.map(s => {
+ switch (s.type) {
+ case 'text':
+ return `${s.content}
`;
+ case 'diagram':
+ return `${s.content}
`;
+ case 'metrics':
+ return `${s.content}
`;
+ case 'code':
+ return `${s.content}`;
+ }
+ }).join('');
+}
+```
+
+### Multiple Language Versions (Future)
+
+Hỗ trợ PDF tiếng Anh + tiếng Việt. Hiện tại chỉ English.
+
+**Approach**:
+- Duplicate template: `resume-template-en.html`, `resume-template-vi.html`
+- Script chạy 2 lần, output `resume-en.pdf`, `resume-vi.pdf`
+- Data modules xuất cả 2 ngôn ngữ: `profile.nameEn`, `profile.nameVi`
diff --git a/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md b/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md
new file mode 100644
index 0000000..f9f1878
--- /dev/null
+++ b/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md
@@ -0,0 +1,626 @@
+# Specification — v2 Resume PDF (Puppeteer)
+
+> **Document:** `spec-v2-resume-puppeteer.md`
+> **Version:** 0.1.0
+> **Parent:** `spec-v2-resume.md`
+> **Priority:** P1
+> **Estimate:** ~4 hours
+
+---
+
+## Requirement
+
+- Generate `resume.pdf` (A4, multi-page, embedded fonts) during build
+- Deployed at `/resume.pdf` (root of `/dist`)
+- Download button in Hero CTA and Contact section (already implemented in `spec-v2-resume.md`)
+- PDF content: Header (with profile photo), Experience, Skills, Projects (all)
+
+---
+
+## PDF Structure
+
+### Page 1: Header + Start of Experience
+
+```
+┌──────────────────────────────────────────┐
+│ [Photo] Dong Nguyen │
+│ Senior Software Engineer │
+│ your.email@example.com │
+│ github.com/... │
+│ linkedin.com/... │
+├──────────────────────────────────────────┤
+│ EXPERIENCE │
+│ │
+│ Senior Software Engineer │
+│ Current Company | 2021 – Present │
+│ Ho Chi Minh City, Vietnam │
+│ │
+│ • System ownership và architecture... │
+│ • Developed IoT-DWS integration... │
+│ • Led system maintenance... │
+│ • Applied Computer Vision... │
+│ • Scrum Master responsibilities... │
+│ │
+│ IoT-DWS Integration System │
+│ Context: Tiếp nhận và nhanh chóng... │
+│ Technical: HTTP integration, HMAC... │
+│ Impact: Giải pháp DWS integration... │
+│ Metrics: 16 sortations deployed │
+│ Tech: Java, HTTP, HMAC, RocketMQ, DWS │
+└──────────────────────────────────────────┘
+```
+
+### Page 2+: Remaining Content
+
+- AWB Detection (if fits with IoT-DWS, else new page)
+- System Maintenance (if fits, else new page)
+- Skills section (always starts on new page)
+- Projects section (each project starts on new page)
+
+### Section Break Rules
+
+- **Experience** section starts on a new page (after header)
+- **Skills** section starts on a new page
+- **Each Project** starts on a new page
+- Experience achievements may flow across pages naturally if space permits
+
+---
+
+## Technology
+
+### Library
+
+```
+puppeteer@^25.13.0 # Puppeteer (bundled Chromium)
+```
+
+- `puppeteer` full package (includes Chromium ~100MB)
+- Installed as `devDependency`
+- Chromium downloaded once, cached in `~/.cache/puppeteer`
+
+### Build Machine
+
+- Gitea runner: `ubuntu-latest`
+- Puppeteer auto-installs Chromium on first run, cached in CI
+
+### Font Embedding
+
+- Font: **Inter** (Google Fonts) — clean, professional, good Vietnamese support
+- Embed via `@font-face` with base64-encoded WOFF2 in HTML template
+- Fallback: `system-ui, -apple-system, sans-serif`
+
+---
+
+## File Structure
+
+
+```
+scripts/
+ generate-resume.mjs # Main build script
+public/
+ resume-template.html # HTML template (with {{placeholders}})
+ resume.css # PDF-specific CSS styles
+ fonts/
+ Inter-Regular.woff2
+ Inter-Medium.woff2
+ Inter-SemiBold.woff2
+ Inter-Bold.woff2
+src/
+ data/
+ resume.ts # Export: resumeAvailable = true
+```
+
+---
+
+## Implementation
+
+### 1. Font Setup
+
+Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold) from Google Fonts.
+Place WOFF2 files in `public/fonts/` directory.
+CSS `@font-face` rules use relative `url()` paths to serve fonts directly.
+
+```css
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 400;
+ font-display: swap;
+ src: url('./fonts/Inter-Regular.woff2') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 500;
+ font-display: swap;
+ src: url('./fonts/Inter-Medium.woff2') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 600;
+ font-display: swap;
+ src: url('./fonts/Inter-SemiBold.woff2') format('woff2');
+}
+@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: 700;
+ font-display: swap;
+ src: url('./fonts/Inter-Bold.woff2') format('woff2');
+}
+```
+
+### 2. CSS File
+
+`public/resume.css` — all PDF-specific styles. Referenced from HTML via ``.
+
+```css
+/* Page layout */
+@page {
+ size: A4;
+ margin: 20mm 18mm 20mm 18mm;
+}
+
+/* Reset */
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body {
+ font-family: 'Inter', system-ui, -apple-system, sans-serif;
+ font-size: 10pt;
+ line-height: 1.5;
+ color: #1a1a1a;
+}
+
+/* Header — avoid break inside */
+.header {
+ display: flex;
+ align-items: center;
+ gap: 16px;
+ padding-bottom: 12px;
+ border-bottom: 2px solid #1a1a1a;
+ margin-bottom: 16px;
+ page-break-inside: avoid;
+}
+
+.header-photo {
+ width: 72px;
+ height: 72px;
+ border-radius: 50%;
+ object-fit: cover;
+ flex-shrink: 0;
+}
+
+.header-info h1 {
+ font-size: 18pt;
+ font-weight: 700;
+ color: #1a1a1a;
+}
+
+.header-info .title {
+ font-size: 11pt;
+ font-weight: 500;
+ color: #4a4a4a;
+ margin-bottom: 4px;
+}
+
+.header-info .contact {
+ font-size: 9pt;
+ color: #666;
+ line-height: 1.6;
+}
+
+/* Section page breaks use explicit .page-break class */
+.page-break { page-break-before: always; }
+
+.section-title {
+ font-size: 12pt;
+ font-weight: 700;
+ text-transform: uppercase;
+ letter-spacing: 0.5pt;
+ color: #1a1a1a;
+ padding-bottom: 4px;
+ border-bottom: 1px solid #ccc;
+ margin-bottom: 10px;
+}
+
+/* Experience — avoid break inside */
+.exp-entry {
+ margin-bottom: 12px;
+ page-break-inside: avoid;
+}
+
+.exp-header {
+ display: flex;
+ justify-content: space-between;
+ align-items: baseline;
+ margin-bottom: 2px;
+}
+
+.exp-title {
+ font-weight: 600;
+ font-size: 11pt;
+ color: #1a1a1a;
+}
+
+.exp-duration {
+ font-size: 9pt;
+ color: #666;
+ white-space: nowrap;
+}
+
+.exp-company {
+ font-size: 10pt;
+ color: #4a4a4a;
+ margin-bottom: 2px;
+}
+
+.exp-location {
+ font-size: 9pt;
+ color: #888;
+ margin-bottom: 4px;
+}
+
+.exp-responsibilities {
+ list-style: disc;
+ padding-left: 16px;
+ margin-bottom: 6px;
+}
+
+.exp-responsibilities li {
+ font-size: 9.5pt;
+ margin-bottom: 2px;
+}
+
+/* Achievement — avoid break inside */
+.achievement {
+ margin-left: 12px;
+ margin-bottom: 8px;
+ page-break-inside: avoid;
+}
+
+.achievement-title {
+ font-weight: 600;
+ font-size: 10pt;
+ color: #1a1a1a;
+ margin-bottom: 2px;
+}
+
+.achievement-context {
+ font-size: 9pt;
+ color: #4a4a4a;
+ margin-bottom: 2px;
+ font-style: italic;
+}
+
+.achievement-tech {
+ font-size: 8.5pt;
+ color: #666;
+}
+
+.achievement-tech span {
+ display: inline-block;
+ background: #f0f0f0;
+ padding: 0 4px;
+ border-radius: 2px;
+ margin-right: 4px;
+}
+
+.achievement-metrics {
+ font-size: 9pt;
+ color: #4a4a4a;
+ margin-top: 2px;
+}
+
+/* Skills */
+.skills-grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr;
+ gap: 8px 24px;
+}
+
+.skill-group-title {
+ font-weight: 600;
+ font-size: 10pt;
+ color: #1a1a1a;
+ margin-bottom: 2px;
+}
+
+.skill-list {
+ font-size: 9pt;
+ color: #4a4a4a;
+ line-height: 1.5;
+}
+
+/* Skill group — avoid break inside */
+.skill-group { page-break-inside: avoid; }
+
+/* Projects — avoid break inside */
+.project {
+ margin-bottom: 12px;
+ page-break-inside: avoid;
+}
+
+.project-title {
+ font-weight: 600;
+ font-size: 11pt;
+ color: #1a1a1a;
+}
+
+.project-role {
+ font-size: 9pt;
+ color: #666;
+ margin-bottom: 2px;
+}
+
+.project-summary {
+ font-size: 9.5pt;
+ color: #4a4a4a;
+ margin-bottom: 4px;
+}
+
+.project-tech {
+ font-size: 8.5pt;
+ color: #666;
+}
+
+.project-tech span {
+ display: inline-block;
+ background: #f0f0f0;
+ padding: 0 4px;
+ border-radius: 2px;
+ margin-right: 4px;
+}
+
+.project-metrics {
+ font-size: 9pt;
+ color: #4a4a4a;
+ margin-top: 2px;
+}
+```
+
+### 3. HTML Template
+
+`public/resume-template.html` — static template with `{{placeholder}}` tokens.
+References external `resume.css` and uses explicit `.page-break` classes for pagination.
+
+```html
+
+
+
+
+ Resume - Dong Nguyen
+
+
+
+
+
+
+
+
+
Experience
+ {{EXPERIENCE}}
+
+
+
+
+
Skills
+
+ {{SKILLS}}
+
+
+
+
+
+
Projects
+ {{PROJECTS}}
+
+
+
+```
+
+### 3. Build Script
+
+`scripts/generate-resume.mjs`:
+
+```javascript
+import puppeteer from 'puppeteer';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+
+// Import data modules (ESM)
+const { profile } = await import(join(ROOT, 'src/data/profile.ts'));
+const { experiences } = await import(join(ROOT, 'src/data/experience.ts'));
+const { skillGroups } = await import(join(ROOT, 'src/data/skills.ts'));
+const { projects } = await import(join(ROOT, 'src/data/projects.ts'));
+
+// Read template
+const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8');
+
+// Read and encode photo
+const photoPath = join(ROOT, 'public/profile-photo.webp');
+const photoBase64 = readFileSync(photoPath).toString('base64');
+
+// Render HTML
+const html = template
+ .replace('{{NAME}}', profile.name)
+ .replace('{{TITLE}}', profile.title)
+ .replace('{{EMAIL}}', profile.email)
+ .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/'))
+ .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/'))
+ .replace('{{PHOTO_BASE64}}', photoBase64)
+ .replace('{{EXPERIENCE}}', renderExperience(experiences))
+ .replace('{{SKILLS}}', renderSkills(skillGroups))
+ .replace('{{PROJECTS}}', renderProjects(projects));
+
+// Generate PDF
+const browser = await puppeteer.launch({
+ headless: 'new',
+ args: ['--no-sandbox', '--disable-setuid-sandbox'],
+});
+const page = await browser.newPage();
+await page.setContent(html, { waitUntil: 'networkidle' });
+
+await page.pdf({
+ path: join(ROOT, 'dist/resume.pdf'),
+ format: 'A4',
+ printBackground: true,
+ margin: { top: '20mm', right: '18mm', bottom: '20mm', left: '18mm' },
+});
+
+await browser.close();
+console.log('resume.pdf generated at dist/resume.pdf');
+```
+
+### 4. HTML Render Helpers
+
+Helper functions in `scripts/resume-html.ts`:
+
+```typescript
+// Renders experience section HTML string
+function renderExperience(experiences: ExperienceEntry[]): string {
+ return experiences.map(exp => `
+
+
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''}
+
+ ${exp.responsibilities.map(r => `- ${r}
`).join('')}
+
+ ${exp.achievements?.map(ach => `
+
+
${ach.title}
+
${ach.context}
+
+ ${ach.technologies.map(t => `${t}`).join('')}
+
+ ${ach.impact ? `
${ach.impact}
` : ''}
+ ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''}
+
+ `).join('')}
+
+ `).join('');
+}
+
+// Renders skills section HTML string
+function renderSkills(skillGroups: SkillGroup[]): string {
+ return skillGroups.map(group => `
+
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join('');
+}
+
+// Renders projects section HTML string
+function renderProjects(projects: ProjectDetail[]): string {
+ return projects.map(project => `
+
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')}
+
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''}
+
+ `).join('');
+}
+```
+
+### 5. Data Detection
+
+Update `src/data/resume.ts`:
+
+```typescript
+export const resumeAvailable = true;
+```
+
+### 6. package.json
+
+```json
+{
+ "scripts": {
+ "build": "tsc -b && vite build && node scripts/generate-resume.mjs"
+ },
+ "devDependencies": {
+ "puppeteer": "^24.0.0"
+ }
+}
+```
+
+---
+
+## Acceptance Criteria
+
+- [ ] `pnpm build` produces `dist/resume.pdf`
+- [ ] PDF is A4 size, multi-page with correct pagination
+- [ ] Header contains profile photo (circular crop), name, title, contact info
+- [ ] Experience section includes all companies, roles, responsibilities, achievements
+- [ ] Skills section includes all skill groups
+- [ ] All projects included (not just featured)
+- [ ] Sections do not split across pages (achievements, projects, skill groups use `page-break-inside: avoid`)
+- [ ] Fonts are embedded (Inter, 4 weights)
+- [ ] PDF is readable and well-formatted (no overflow, text not cut off)
+- [ ] Works in Gitea CI (`ubuntu-latest`)
+- [ ] Works locally on Windows dev machine
+- [ ] Download button shows in Hero and Contact sections
+
+---
+
+## Tradeoffs
+
+| Aspect | Detail |
+|--------|--------|
+| Bundle size | ~100MB (Puppeteer + Chromium) |
+| Build time | +10-20s (download once cached, render ~2s) |
+| CSS control | Full CSS (same as website) |
+| Font embedding | Base64 in HTML, increases HTML size ~50KB |
+| Photo | Inline base64 (avoids file:// URL issues) |
+| Platform | Works on Ubuntu CI, Windows local |
+
+---
+
+## Puppeteer vs Playwright Comparison
+
+| Aspect | Puppeteer | Playwright |
+|--------|-----------|------------|
+| Package | `puppeteer` | `playwright` |
+| Size | ~100MB | ~100MB |
+| API | `puppeteer.launch()` | `chromium.launch()` |
+| PDF API | `page.pdf()` | `page.pdf()` |
+| CSS support | Full (Chromium) | Full (Chromium) |
+| CI support | Excellent | Excellent |
+| Community | Larger, more examples | Growing rapidly |
+| TypeScript | Built-in types | Built-in types |
+| Headless flags | `--no-sandbox` needed for CI | `--no-sandbox` via config |
+
+Both produce identical PDF output (same Chromium engine). Choice is preference.
+
+---
+
+## Future Enhancements
+
+1. **Gitea workflow**: Move script execution into `deploy.yml` for cleaner separation
+2. **CI caching**: Cache Puppeteer Chromium in Gitea workflow
+3. **PDF metadata**: Set PDF title, author, creator
+4. **Version stamping**: Add "Last updated: YYYY-MM-DD" to footer
+5. **Conditional content**: Hide contact info if placeholder values detected
diff --git a/package.json b/package.json
index c458609..5113629 100644
--- a/package.json
+++ b/package.json
@@ -21,6 +21,8 @@
"@types/react-dom": "^19.2.7",
"@vitejs/plugin-react": "^6.1.1",
"oxlint": "^1.81.0",
+ "playwright": "^1.64.0",
+ "tsx": "^4.23.15",
"typescript": "~6.0.2",
"vite": "^8.3.0"
}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 78ec43e..e62aad2 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -190,19 +190,181 @@ importers:
version: 19.3.0(@types/react@19.3.0)
'@vitejs/plugin-react':
specifier: ^6.1.1
- version: 6.1.1(vite@8.3.2(@types/node@24.19.1))
+ version: 6.1.1(vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15))
oxlint:
specifier: ^1.81.0
version: 1.86.0
+ playwright:
+ specifier: ^1.64.0
+ version: 1.64.0
+ tsx:
+ specifier: ^4.23.15
+ version: 4.23.15
typescript:
specifier: ~6.0.2
version: 6.0.3
vite:
specifier: ^8.3.0
- version: 8.3.2(@types/node@24.19.1)
+ version: 8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15)
packages:
+ '@esbuild/aix-ppc64@0.28.2':
+ resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@esbuild/android-arm64@0.28.2':
+ resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
+ '@esbuild/android-arm@0.28.2':
+ resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
+ '@esbuild/android-x64@0.28.2':
+ resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
+ '@esbuild/darwin-arm64@0.28.2':
+ resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@esbuild/darwin-x64@0.28.2':
+ resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@esbuild/freebsd-arm64@0.28.2':
+ resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-x64@0.28.2':
+ resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@esbuild/linux-arm64@0.28.2':
+ resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
+ '@esbuild/linux-arm@0.28.2':
+ resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
+ '@esbuild/linux-ia32@0.28.2':
+ resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
+ '@esbuild/linux-loong64@0.28.2':
+ resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@esbuild/linux-mips64el@0.28.2':
+ resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@esbuild/linux-ppc64@0.28.2':
+ resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@esbuild/linux-riscv64@0.28.2':
+ resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@esbuild/linux-s390x@0.28.2':
+ resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@esbuild/linux-x64@0.28.2':
+ resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/netbsd-arm64@0.28.2':
+ resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-x64@0.28.2':
+ resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/openbsd-arm64@0.28.2':
+ resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-x64@0.28.2':
+ resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/openharmony-arm64@0.28.2':
+ resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@esbuild/sunos-x64@0.28.2':
+ resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@esbuild/win32-arm64@0.28.2':
+ resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@esbuild/win32-ia32@0.28.2':
+ resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@esbuild/win32-x64@0.28.2':
+ resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
'@oxc-project/types@0.152.0':
resolution: {integrity: sha512-oM/5rLBm2tPkg0iBgkH/FOeR3PCDpY19GTgAZjMFM8h9WI9VW7cLgzp6nwtarYKmovavIQZ+Fe/RKX/8C8O/Rw==}
@@ -467,6 +629,11 @@ packages:
resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
engines: {node: '>=8'}
+ esbuild@0.28.2:
+ resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==}
+ engines: {node: '>=18'}
+ hasBin: true
+
fdir@6.5.0:
resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
engines: {node: '>=12.0.0'}
@@ -608,6 +775,16 @@ packages:
resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==}
engines: {node: '>=12'}
+ playwright-core@1.64.0:
+ resolution: {integrity: sha512-T9r+MZkTECl2+oUcZ26YgZzTrYidTsIhYYkJix+6iDOymOb1FB2RLLSOxRGnZGv5DStt+aduIVbt+E8WygXYpg==}
+ engines: {node: '>=20'}
+ hasBin: true
+
+ playwright@1.64.0:
+ resolution: {integrity: sha512-kVzTnYFYEyQ9RGzBjNCd2+yEqWmVbxl3AHPynv3qQ6JTjv4a+kwRcnqQwIpuP3NnrnIrE/Q6wWAIAvMfIE2/Yg==}
+ engines: {node: '>=20'}
+ hasBin: true
+
postcss@8.5.28:
resolution: {integrity: sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==}
engines: {node: ^10 || ^12 || >=14}
@@ -650,6 +827,11 @@ packages:
tslib@2.8.1:
resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+ tsx@4.23.15:
+ resolution: {integrity: sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==}
+ engines: {node: '>=18.0.0'}
+ hasBin: true
+
typescript@6.0.3:
resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
engines: {node: '>=14.17'}
@@ -703,6 +885,84 @@ packages:
snapshots:
+ '@esbuild/aix-ppc64@0.28.2':
+ optional: true
+
+ '@esbuild/android-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/android-arm@0.28.2':
+ optional: true
+
+ '@esbuild/android-x64@0.28.2':
+ optional: true
+
+ '@esbuild/darwin-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/darwin-x64@0.28.2':
+ optional: true
+
+ '@esbuild/freebsd-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/freebsd-x64@0.28.2':
+ optional: true
+
+ '@esbuild/linux-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/linux-arm@0.28.2':
+ optional: true
+
+ '@esbuild/linux-ia32@0.28.2':
+ optional: true
+
+ '@esbuild/linux-loong64@0.28.2':
+ optional: true
+
+ '@esbuild/linux-mips64el@0.28.2':
+ optional: true
+
+ '@esbuild/linux-ppc64@0.28.2':
+ optional: true
+
+ '@esbuild/linux-riscv64@0.28.2':
+ optional: true
+
+ '@esbuild/linux-s390x@0.28.2':
+ optional: true
+
+ '@esbuild/linux-x64@0.28.2':
+ optional: true
+
+ '@esbuild/netbsd-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/netbsd-x64@0.28.2':
+ optional: true
+
+ '@esbuild/openbsd-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/openbsd-x64@0.28.2':
+ optional: true
+
+ '@esbuild/openharmony-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/sunos-x64@0.28.2':
+ optional: true
+
+ '@esbuild/win32-arm64@0.28.2':
+ optional: true
+
+ '@esbuild/win32-ia32@0.28.2':
+ optional: true
+
+ '@esbuild/win32-x64@0.28.2':
+ optional: true
+
'@oxc-project/types@0.152.0': {}
'@oxlint/binding-android-arm-eabi@1.86.0':
@@ -823,10 +1083,10 @@ snapshots:
dependencies:
csstype: 3.2.3
- '@vitejs/plugin-react@6.1.1(vite@8.3.2(@types/node@24.19.1))':
+ '@vitejs/plugin-react@6.1.1(vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15))':
dependencies:
'@rolldown/pluginutils': 1.0.1
- vite: 8.3.2(@types/node@24.19.1)
+ vite: 8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15)
cookie-es@3.1.1: {}
@@ -834,6 +1094,35 @@ snapshots:
detect-libc@2.1.2: {}
+ esbuild@0.28.2:
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.28.2
+ '@esbuild/android-arm': 0.28.2
+ '@esbuild/android-arm64': 0.28.2
+ '@esbuild/android-x64': 0.28.2
+ '@esbuild/darwin-arm64': 0.28.2
+ '@esbuild/darwin-x64': 0.28.2
+ '@esbuild/freebsd-arm64': 0.28.2
+ '@esbuild/freebsd-x64': 0.28.2
+ '@esbuild/linux-arm': 0.28.2
+ '@esbuild/linux-arm64': 0.28.2
+ '@esbuild/linux-ia32': 0.28.2
+ '@esbuild/linux-loong64': 0.28.2
+ '@esbuild/linux-mips64el': 0.28.2
+ '@esbuild/linux-ppc64': 0.28.2
+ '@esbuild/linux-riscv64': 0.28.2
+ '@esbuild/linux-s390x': 0.28.2
+ '@esbuild/linux-x64': 0.28.2
+ '@esbuild/netbsd-arm64': 0.28.2
+ '@esbuild/netbsd-x64': 0.28.2
+ '@esbuild/openbsd-arm64': 0.28.2
+ '@esbuild/openbsd-x64': 0.28.2
+ '@esbuild/openharmony-arm64': 0.28.2
+ '@esbuild/sunos-x64': 0.28.2
+ '@esbuild/win32-arm64': 0.28.2
+ '@esbuild/win32-ia32': 0.28.2
+ '@esbuild/win32-x64': 0.28.2
+
fdir@6.5.0(picomatch@4.0.7):
optionalDependencies:
picomatch: 4.0.7
@@ -941,6 +1230,12 @@ snapshots:
picomatch@4.0.7: {}
+ playwright-core@1.64.0: {}
+
+ playwright@1.64.0:
+ dependencies:
+ playwright-core: 1.64.0
+
postcss@8.5.28:
dependencies:
nanoid: 3.3.19
@@ -994,11 +1289,17 @@ snapshots:
tslib@2.8.1: {}
+ tsx@4.23.15:
+ dependencies:
+ esbuild: 0.28.2
+ optionalDependencies:
+ fsevents: 2.3.3
+
typescript@6.0.3: {}
undici-types@7.24.6: {}
- vite@8.3.2(@types/node@24.19.1):
+ vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15):
dependencies:
lightningcss: 1.33.0
picomatch: 4.0.7
@@ -1007,4 +1308,6 @@ snapshots:
tinyglobby: 0.2.17
optionalDependencies:
'@types/node': 24.19.1
+ esbuild: 0.28.2
fsevents: 2.3.3
+ tsx: 4.23.15
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 0000000..5ed0b5a
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,2 @@
+allowBuilds:
+ esbuild: true
diff --git a/public/fonts/Inter-Bold.woff2 b/public/fonts/Inter-Bold.woff2
new file mode 100644
index 0000000..775f757
Binary files /dev/null and b/public/fonts/Inter-Bold.woff2 differ
diff --git a/public/fonts/Inter-Medium.woff2 b/public/fonts/Inter-Medium.woff2
new file mode 100644
index 0000000..21db794
Binary files /dev/null and b/public/fonts/Inter-Medium.woff2 differ
diff --git a/public/fonts/Inter-Regular.woff2 b/public/fonts/Inter-Regular.woff2
new file mode 100644
index 0000000..891fc5c
Binary files /dev/null and b/public/fonts/Inter-Regular.woff2 differ
diff --git a/public/fonts/Inter-SemiBold.woff2 b/public/fonts/Inter-SemiBold.woff2
new file mode 100644
index 0000000..da1c039
Binary files /dev/null and b/public/fonts/Inter-SemiBold.woff2 differ
diff --git a/public/resume-template.html b/public/resume-template.html
new file mode 100644
index 0000000..7352d1a
--- /dev/null
+++ b/public/resume-template.html
@@ -0,0 +1,284 @@
+
+
+
+
+ Resume - Dong Nguyen
+
+
+
+
+
+
+
+
+
Experience
+ {{EXPERIENCE}}
+
+
+
+
+
Skills
+
+ {{SKILLS}}
+
+
+
+
+
+
Projects
+ {{PROJECTS}}
+
+
+
diff --git a/scripts/generate-resume.ts b/scripts/generate-resume.ts
new file mode 100644
index 0000000..6830cc7
--- /dev/null
+++ b/scripts/generate-resume.ts
@@ -0,0 +1,138 @@
+import { chromium } from 'playwright';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { profile } from '../src/data/profile.js';
+import { experiences } from '../src/data/experience.js';
+import { skillGroups } from '../src/data/skills.js';
+import { projects } from '../src/data/projects.js';
+const ROOT = resolve(import.meta.dirname, '..');
+
+// --- Validate required files ---
+const requiredFiles = [
+ 'public/profile-photo.webp',
+ 'public/fonts/Inter-Regular.woff2',
+ 'public/fonts/Inter-Medium.woff2',
+ 'public/fonts/Inter-SemiBold.woff2',
+ 'public/fonts/Inter-Bold.woff2',
+ 'public/resume-template.html',
+];
+
+for (const file of requiredFiles) {
+ if (!existsSync(join(ROOT, file))) {
+ console.error(`❌ Missing required file: ${file}`);
+ process.exit(1);
+ }
+}
+
+// --- Read template ---
+const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8');
+
+// --- Read and base64-encode assets ---
+const photoBase64 = readFileSync(join(ROOT, 'public/profile-photo.webp')).toString('base64');
+
+const fonts: Record = {};
+for (const [name, weight] of [
+ ['REGULAR', 'Inter-Regular.woff2'],
+ ['MEDIUM', 'Inter-Medium.woff2'],
+ ['SEMIBOLD', 'Inter-SemiBold.woff2'],
+ ['BOLD', 'Inter-Bold.woff2'],
+] as const) {
+ fonts[name] = readFileSync(join(ROOT, 'public/fonts', weight)).toString('base64');
+}
+
+// --- Generate font-face CSS ---
+const fontFaces = Object.entries(fonts).map(([key, b64]) => {
+ const weightMap: Record = { REGULAR: 400, MEDIUM: 500, SEMIBOLD: 600, BOLD: 700 };
+ return `@font-face {
+ font-family: 'Inter';
+ font-style: normal;
+ font-weight: ${weightMap[key]};
+ font-display: swap;
+ src: url('data:font/woff2;base64,${b64}') format('woff2');
+}`;
+}).join('\n');
+
+// --- Render HTML helpers ---
+function renderExperience(exps: typeof experiences): string {
+ return exps.map(exp => `
+
+
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''}
+
+ ${exp.responsibilities.map(r => `- ${r}
`).join('')}
+
+ ${exp.achievements?.map(ach => `
+
+
${ach.title}
+
${ach.context}
+ ${ach.technicalWork?.length ? `
+
+ ${ach.technicalWork.map(t => `- ${t}
`).join('')}
+
+ ` : ''}
+
+ ${ach.technologies.map(t => `${t}`).join('')}
+
+ ${ach.impact ? `
${ach.impact}
` : ''}
+ ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''}
+
+ `).join('')}
+
+ `).join('');
+}
+
+function renderSkills(groups: typeof skillGroups): string {
+ return groups.map(group => `
+
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join('');
+}
+
+function renderProjects(projs: typeof projects): string {
+ return projs.map(project => `
+
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')}
+
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''}
+
+ `).join('');
+}
+
+// --- Assemble HTML ---
+const html = template
+ .replace('{{NAME}}', profile.name)
+ .replace('{{TITLE}}', profile.title)
+ .replace('{{EMAIL}}', profile.email)
+ .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/'))
+ .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/'))
+ .replace('{{PHOTO_BASE64}}', photoBase64)
+ .replace('{{FONT_FACES}}', fontFaces)
+ .replace('{{EXPERIENCE}}', renderExperience(experiences))
+ .replace('{{SKILLS}}', renderSkills(skillGroups))
+ .replace('{{PROJECTS}}', renderProjects(projects));
+
+// --- Generate PDF ---
+const browser = await chromium.launch();
+const page = await browser.newPage();
+await page.setContent(html); // No waitUntil needed — all resources inline
+
+const outputPath = join(ROOT, 'dist/resume.pdf');
+await page.pdf({
+ path: outputPath,
+ format: 'A4',
+ printBackground: true,
+ // margin inherited from @page CSS
+});
+
+await browser.close();
+console.log(`resume.pdf generated at ${outputPath}`);