{
  "spec": "quick-html/v0",
  "id": "cover-letter",
  "version": "0.1.0",
  "name": "Cover Letter",
  "description": "Elegant one-page A4 application letter: refined letterhead, recipient block, subject line, well-paced body paragraphs and an optional 'why me' highlights strip. Matching sibling of the CV template — together they form a complete job-application set.",
  "useWhen": [
    "cover letter",
    "application letter",
    "motivation letter",
    "job application letter",
    "motivatiebrief",
    "sollicitatiebrief",
    "anschreiben",
    "lettre de motivation"
  ],
  "format": "printable",
  "theme": "career",
  "audience": [
    "jobseeker"
  ],
  "language": "en",
  "page": {
    "size": "A4",
    "orientation": "portrait"
  },
  "modules": [
    "edit-overlay",
    "print-helper"
  ],
  "slots": [
    {
      "name": "doc-title",
      "type": "text",
      "required": true,
      "example": "Cover letter — Merel Jansen",
      "notes": "Browser tab title; used as the download filename."
    },
    {
      "name": "applicant-name",
      "type": "text",
      "required": true,
      "example": "Merel Jansen"
    },
    {
      "name": "applicant-contact",
      "type": "html",
      "required": true,
      "example": "<p>Rotterdam, NL · +31 6 21 44 87 90 · merel.jansen@example.com · linkedin.com/in/mereljansen</p>",
      "notes": "1–2 <p> lines: city · phone · email · optional link, '·'-separated. Keep each line under ~95 chars."
    },
    {
      "name": "letter-date",
      "type": "date",
      "required": true,
      "example": "14 Aug 2026",
      "notes": "Format exactly like the placeholder: '14 Aug 2026'."
    },
    {
      "name": "recipient-name",
      "type": "text",
      "required": true,
      "example": "Ms Hannah Smit",
      "notes": "Person if known, otherwise company or '[HIRING MANAGER]'."
    },
    {
      "name": "recipient-details",
      "type": "html",
      "required": true,
      "example": "<p>Head of Product, Kadewerk B.V.</p><p>Wilhelminakade 143</p><p>3072 AP Rotterdam</p>",
      "notes": "1–4 <p> lines: role + company, street, postcode + city. Use [PLACEHOLDERS] for unknown lines."
    },
    {
      "name": "subject-line",
      "type": "text",
      "required": true,
      "example": "Application — Lead Product Manager, Monetisation (vacancy 2026-114)",
      "notes": "Exact role title + vacancy reference if any. Keep under ~80 chars."
    },
    {
      "name": "salutation",
      "type": "text",
      "required": true,
      "example": "Dear Ms Smit,",
      "notes": "'Dear hiring team,' when no name is known."
    },
    {
      "name": "letter-body",
      "type": "html",
      "required": true,
      "example": "<p>When Kadewerk announced that its forwarder platform would move from per-seat licences to transaction-based pricing, I read the release notes twice…</p>",
      "notes": "3–5 <p>, ~180–240 words total: company-specific hook, quantified proof paragraph, why this company, confident close with availability."
    },
    {
      "name": "highlights-label",
      "type": "text",
      "required": false,
      "example": "Why me — at a glance",
      "notes": "Inside the highlights optional. Translate when the letter is not in English; keep under ~30 chars."
    },
    {
      "name": "highlights-content",
      "type": "html",
      "required": false,
      "example": "<ul><li>Usage-based pricing shipped at Flowbase — NRR 104% → 117%</li><li>Eight years of B2B SaaS product; €0 → €6m ARR</li><li>Rotterdam-based · available from 1 October</li></ul>",
      "notes": "Inside the highlights optional. <ul> of exactly 3 items, each one line (≤60 chars): quantified proof, specialism, availability."
    },
    {
      "name": "closing",
      "type": "text",
      "required": true,
      "example": "Kind regards,"
    },
    {
      "name": "signature-name",
      "type": "text",
      "required": true,
      "example": "Merel Jansen"
    },
    {
      "name": "attachments-line",
      "type": "text",
      "required": false,
      "example": "Enclosed: CV · one-page case study of the Flowbase pricing migration",
      "notes": "Inside the attachments optional. Only list documents actually enclosed."
    },
    {
      "name": "footer-line",
      "type": "text",
      "required": false,
      "example": "Merel Jansen · Rotterdam · merel.jansen@example.com",
      "notes": "Small footer line: name · city · email."
    }
  ],
  "repeats": [],
  "optionals": [
    {
      "name": "highlights",
      "description": "'Why me — at a glance' strip between body and closing: 3 one-line facts. Remove when the user lacks three crisp facts or the letter runs long."
    },
    {
      "name": "attachments",
      "description": "'Enclosed: …' line under the signature. Remove when nothing is enclosed."
    }
  ],
  "tags": [
    "job-application",
    "letter",
    "motivation"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "date": "2026-08-14",
      "notes": "Initial release: one-page letter sharing the CV template's palette and typography, with highlights strip and attachments optionals."
    }
  ],
  "agentInstructions": "Tone: confident, specific, first person; zero clichés ('team player', 'passionate', 'proven track record') and no flattery padding. Tailor everything to the actual vacancy: exact role title and reference number in subject-line, and an opening paragraph that hooks into something real about that company (product, announcement, market) — never a generic opener. Never invent employers, achievements, numbers or recipient details — use only facts the user provides; ask when a key fact is missing, or leave recognizable placeholders like [HIRING MANAGER] / [COMPANY ADDRESS] / [VACANCY REF] and tell the user to fill them via the built-in Edit button ('Dear hiring team,' is the fallback salutation). Body: 3–5 <p> — hook tied to the company, one proof paragraph with a quantified result, why this company, confident close with availability; if the user supplies more material, compress to 4 paragraphs max — the letter must stay on one page. Dates like the placeholder: '14 Aug 2026'. Remove the highlights optional when the user has fewer than three crisp facts or space is tight; remove the attachments optional when nothing is enclosed. Match the letter's language to the vacancy, including salutation and closing.",
  "license": "MIT",
  "authors": [
    {
      "github": "bvrln"
    }
  ]
}