Nick's Resume Generator

Generate an HTML and PDF resume with Node.js, Puppeteer, and Pug.

Set up the repository

The bootstrap scripts install pinned copies of mise, Task, Node.js, and all npm and Puppeteer dependencies inside this repository. They do not require administrator access or modify your shell profile.

On Linux or macOS:

./bootstrap.sh

On Windows PowerShell:

.\bootstrap.ps1

Bootstrap is safe to run again. To provision the tools and run a specific task, pass the task name and its arguments:

./bootstrap.sh check
./bootstrap.sh generate -- --file exampleData.yaml --no-pdf

.\bootstrap.ps1 check
.\bootstrap.ps1 generate -- --file exampleData.yaml --no-pdf

Generate a resume

Copy the example data and replace it with your information:

cp exampleData.yaml myResume.yaml

Then generate HTML and PDF output in dist/. Use the bootstrap wrapper so the command always runs with the repository's pinned tools:

./bootstrap.sh generate -- --file myResume.yaml --template green-columns

.\bootstrap.ps1 generate -- --file myResume.yaml --template green-columns

Available templates are green-columns, man-page, and simple. The simple template uses a single-column, text-first layout designed for clear reading and reliable resume parsing. Add --no-pdf to skip launching Chrome and generate only HTML.

Group multiple roles at one employer under roles:

experience:
- company: Example Company
  timeFrame: 2021 - Present
  roles:
  - title: Senior Engineer
    focusArea: Platform Reliability
    details:
    - Led delivery for a platform used across several product teams.
  - title: Engineer
    details:
    - Built and maintained reliable services for customer-facing products.

Each role uses a details list, whether it contains one short description or several. Use the optional focusArea field to distinguish a specialization from the formal job title. The original flat company, title, timeFrame, and details format remains supported for existing resume data. Omit the company timeFrame to show dates beside individual roles instead. Legacy summary values are preserved as the first item in details.

Add an optional keyword-focused Technologies section to the end of the simple template:

usedTechnologies:
  headline: A word cloud of technologies I've used to appease the machine scanning this resume.
  groups:
  - title: Languages
    items:
    - TypeScript
    - Go
  - title: Platform
    items:
    - Kubernetes
    - Docker

Grouped technologies render with a bold category label followed by normal-weight keywords. The original additionalDetails list remains supported for existing resume files.

Common tasks

Pass a Task command to the bootstrap script, such as ./bootstrap.sh check or .\bootstrap.ps1 check. If mise is already active in your shell, you can also run the underlying task commands directly. Run task to list every command.

The main repository activities are:

Command	Purpose
task setup	Install exact locked dependencies and show tool versions
task check	Run linting, type-checking, unit tests, the production build, and template smoke tests
task generate -- --file <yaml>	Build and generate a resume
task format	Format source and configuration files
task deps:outdated	Report outdated direct npm dependencies
task deps:update	Update direct dependencies to stable latest versions and validate them
task clean	Remove generated output

Pinned tool versions are declared in mise.toml; the bootstrapped mise release and archive checksums are declared in versions.env.