# Specification — v3 Resume PDF Improvements
> **Document:** `spec-v3-resume-improvements.md`
> **Version:** 0.3.0 (adds section reordering: Projects → Skills)
> **Parent:** `spec-v2-resume-playwright.md`
> **Priority:** P2
> **Estimate:** ~1 hour
---
## Problem
### 1. Missing Professional Summary in Resume
The resume PDF lacks a professional summary section. Currently it goes directly from header to experience, which is less informative for recruiters who scan the top of a resume first.
The `{{BIO}}` placeholder is resolved in `scripts/generate-resume.ts` (line 145) but never rendered in the HTML template — dead code.
### 2. Inter Font Poor Vietnamese Support
Current font **Inter** does not render Vietnamese diacritics well in PDF output. Characters like `ơ`, `ư`, `đ`, `ê`, `ô` may appear broken or misaligned.
**Decision:** Replace Inter with **Source Sans 3** (Adobe open-source) — excellent Vietnamese support, professional style, similar to Inter's clean aesthetic.
### 3. No HTML Preview Mode for Debugging
When debugging PDF layout, the only option is to generate the full PDF and open it. This requires:
- Running Playwright (slow)
- Waiting for Chromium to launch
- Generating PDF (2-3s)
- Opening PDF viewer
Layout iteration takes 5-10 seconds per cycle. Adding a preview mode that opens HTML directly in the browser would reduce iteration to <1 second.
---
## Goal
1. Add "About me" section with bio content after header, before Experience
2. Add `--preview` flag to open rendered HTML in browser (no PDF generation)
3. Add `build:resume-preview` npm script for convenience
4. Replace Inter font with Source Sans 3 for better Vietnamese support
---
## Current Implementation
### Script: `scripts/generate-resume.ts`
Bio resolved but not rendered:
```typescript
// Line 145 — resolves bio but template has no {{BIO}} placeholder
.replace('{{BIO}}', resolveField(profile.bioEn, profile.bio))
```
PDF generation (lines 160-178):
```typescript
const browser = await chromium.launch();
const page = await browser.newPage();
await page.setContent(html);
const langSuffix = lang === 'en' ? '' : `-${lang}`;
const outputPath = join(ROOT, `dist/resume${langSuffix}.pdf`);
await page.pdf({
path: outputPath,
format: 'A4',
printBackground: true,
title: `Resume - ${profile.name} (${lang === 'en' ? 'English' : 'Vietnamese'})`,
author: profile.name,
});
await browser.close();
console.log(`resume${langSuffix}.pdf generated at ${outputPath} [${lang}]`);
```
### Template: `public/resume-template.html`
Structure (lines 259-298):
```html
...
...
...
...
```
No `{{BIO}}` placeholder exists in the template.
### Package.json Scripts
```json
{
"scripts": {
"build:resume": "pnpm tsx scripts/generate-resume.ts",
"build:resume-all": "pnpm tsx scripts/generate-resume.ts --lang=en && pnpm tsx scripts/generate-resume.ts --lang=vi"
}
}
```
---
## Implementation
### Font Change: Inter → Source Sans 3
**Files affected:**
- `public/fonts/` — replace `Inter-*.woff2` with `SourceSans3-*.woff2`
- `scripts/generate-resume.ts` — update font file names and weight mapping
- `public/resume-template.html` — update `@font-face` font-family name
**Source Sans 3 weights needed:**
- Regular (400) → `SourceSans3-Regular.ttf.woff2`
- Medium (500) → `SourceSans3-Medium.ttf.woff2`
- Semibold (600) → `SourceSans3-Semibold.ttf.woff2`
- Bold (700) → `SourceSans3-Bold.ttf.woff2`
**Script changes:**
1. Replace font file names in the validation loop and font loading loop
2. Update `@font-face` CSS to use `font-family: 'Source Sans 3'`
3. Update `body { font-family: 'Inter', ... }` → `font-family: 'Source Sans 3', ...`
**Note:** Download fonts from [Adobe Fonts / Google Fonts](https://fonts.google.com/specimen/Source+Sans+3). Extract `.woff2` files from the TTF/OTF originals using a converter if needed.
### Section Reordering: Projects → Skills
**Current order:** Header → About me → Experience → Skills → Projects
**New order:** Header → About me → Experience → Projects → Skills
**Rationale:** Skills are more generic/less impactful than Projects. Placing Projects before Skills gives recruiters a clearer view of concrete work experience before technical skills.
**Change:** Swap the Projects and Skills `` blocks in `public/resume-template.html` (around lines 280-292).
### Step 1: Add CSS for About me Section
**File:** `public/resume-template.html:56-60`
Add after `.header-info .contact` style block:
```css
/* About me */
.about-summary {
font-size: 9.5pt;
color: #4a4a4a;
line-height: 1.6;
margin-bottom: 12px;
page-break-inside: avoid;
}
```
### Step 2: Add About me Section to Template
**File:** `public/resume-template.html:272-273`
Insert between header `
` and Experience ``:
```html
{{ABOUT_ME_LABEL}}
{{BIO}}
...
...
...
```
**Note:** The section uses `.section` class which has `page-break-before: always` for subsequent sections. Since About me comes right after header (first section), it will NOT trigger a page break — it flows naturally after the header on the same page.
### Step 3: Reorder Sections (Projects → Skills)
**File:** `public/resume-template.html:280-292`
Swap the Projects and Skills `
` blocks:
```html
...
...
...
```
### Step 4: Add --preview Flag to Script
**File:** `scripts/generate-resume.ts`
Add preview mode detection after language parsing (around line 15):
```typescript
// --- CLI args ---
const args = process.argv.slice(2);
const langArg = (args.find(a => a.startsWith('--lang=')) || '').replace('--lang=', '') as Language;
const lang: Language = (langArg === 'en' || langArg === 'vi') ? langArg : 'en';
const previewMode = args.includes('--preview');
```
Add `ABOUT_ME` to labels object (around line 66):
```typescript
const labels: Record
> = {
en: {
EXPERIENCE: 'Experience',
SKILLS: 'Skills',
PROJECTS: 'Projects',
ABOUT_ME: 'About me',
},
vi: {
EXPERIENCE: 'Kinh nghiệm',
SKILLS: 'Kỹ năng',
PROJECTS: 'Dự án',
ABOUT_ME: 'Về tôi',
},
};
```
Replace PDF generation block (lines 160-178) with conditional:
```typescript
// --- Generate output ---
const browser = await chromium.launch();
const page = await browser.newPage();
await page.setContent(html);
if (previewMode) {
await page.bringToFront();
console.log(`Preview opened in browser [${lang}] — close manually to exit`);
await new Promise(() => {}); // Keep browser open indefinitely
} else {
const langSuffix = lang === 'en' ? '' : `-${lang}`;
const outputPath = join(ROOT, `dist/resume${langSuffix}.pdf`);
await page.pdf({
path: outputPath,
format: 'A4',
printBackground: true,
title: `Resume - ${profile.name} (${lang === 'en' ? 'English' : 'Vietnamese'})`,
author: profile.name,
});
await browser.close();
console.log(`resume${langSuffix}.pdf generated at ${outputPath} [${lang}]`);
}
```
**Behavior:**
- `--preview` opens browser with rendered HTML, waits for user to close manually
- No PDF generated, no file saved
- User can inspect layout, test CSS changes, then re-run with `pnpm build:resume` to generate PDF
- `await new Promise(() => {})` — empty promise that never resolves, keeps process alive until user closes browser
**Edge cases:**
- `--preview` with `--lang=vi` works correctly
- `--preview` cannot be combined with normal output (no PDF + preview at same time) — not a use case
- Ctrl+C still terminates the process (Node.js signal handling)
### Step 5: Add build:resume-preview Script
**File:** `package.json`
Add after `build:resume-all`:
```json
{
"scripts": {
"build:resume": "pnpm tsx scripts/generate-resume.ts",
"build:resume-all": "pnpm tsx scripts/generate-resume.ts --lang=en && pnpm tsx scripts/generate-resume.ts --lang=vi",
"build:resume-preview": "pnpm tsx scripts/generate-resume.ts --preview"
}
}
```
### Step 6: Remove Dead {{TAGLINE}} Replace
**File:** `scripts/generate-resume.ts:144`
Remove the dead replace since `{{TAGLINE}}` is also not in the template:
```diff
- .replace('{{TAGLINE}}', resolveField(profile.taglineEn, profile.tagline))
```
---
## Acceptance Criteria
| # | Requirement | Status |
|---|-------------|--------|
| 1 | "About me" section appears after header, before Experience | ✅ |
| 2 | Bio content uses `resolveField` for bilingual support | ✅ |
| 3 | About me section title is bilingual (EN: "About me", VI: "Về tôi") | ✅ |
| 4 | About me section has page-break-inside: avoid | ✅ |
| 5 | About me flows on same page as header (no forced page break) | ✅ |
| 7 | `{{TAGLINE}}` dead code removed | ✅ |
| 8 | `build:resume-all` still generates both EN and VI PDFs | ✅ |
| 9 | `{{BIO}}` placeholder now rendered in template (no longer dead code) | ✅ |
| 10 | Source Sans 3 replaces Inter — Vietnamese diacritics render correctly | ✅ |
---
## Tradeoffs
| Aspect | Detail |
|--------|--------|
| About me page break | Uses `.section` class (page-break-before on subsequent sections) — About me is second section, header is first, so no page break triggered |
| Preview mode lifecycle | `await new Promise(() => {})` — process stays alive until Ctrl+C or browser window closed |
| Bio length | ~2 lines in English, ~2-3 lines in Vietnamese — fits comfortably on page 1 after header |
| CSS specificity | `.about-summary` is standalone class, no conflict with existing styles |
| Font change | Source Sans 3 ~900KB (4 weights) vs Inter ~800KB — slight size increase (~100KB) |
---
## Files Changed
| File | Action | Lines |
| `public/fonts/` | Replace | 4 files: Inter → Source Sans 3 (Regular, Medium, Semibold, Bold) |
| `public/resume-template.html` | Edit | +9 lines (CSS), +5 lines (HTML body), ~12 lines (section reorder) |
| `scripts/generate-resume.ts` | Edit | +3 lines (preview flag), +15 lines (labels ABOUT_ME), +15 lines (conditional generation), +3 lines (ABOUT_ME replace), -1 line (dead TAGLINE) |
| `package.json` | Edit | +1 line (new script) |
---
## Bugs Fixed
| # | Issue | Fix |
+---|-------|-----|
+ 1 | `@font-face` font-family was `'Inter'` but body uses `'Source Sans 3'` — PDF would fallback to system font | Changed `scripts/generate-resume.ts:55` to `font-family: 'Source Sans 3'` |
---
## Progress
- [x] Font: Replace Inter with Source Sans 3 (4 weights) in `public/fonts/`, script, and template
- [x] Step 1: CSS for About me section
- [x] Step 2: About me section in template
- [x] Step 3: Reorder sections (Projects → Skills)
- [x] Step 4: Add --preview flag, labels ABOUT_ME, and ABOUT_ME_LABEL replace
- [x] Step 5: Add build:resume-preview script
- [x] Step 6: Remove dead {{TAGLINE}} replace
- [x] Verify: `pnpm build:resume` generates correct PDF
- [x] Verify: `pnpm build:resume-preview` opens browser
- [x] Verify: `pnpm build:resume-all` generates both languages