Stephen Brown II - Resume Generator

Source repository for my resume. The canonical data lives in resume.yaml (validated against schema.json); a renderer reads it and writes a self-contained docs/index.html, which GitHub Pages serves at https://stephenbrown2.github.io/resume/.

---

Repository layout

resume.yaml          # resume data (hybrid JSON Resume / FRESH schema)
schema.json          # JSON Schema Draft 2020-12 for resume.yaml
docs/index.html      # generated output - committed and served by GitHub Pages
themes/              # alternate HTML layouts (not yet wired into any renderer)
plans/               # implementation plans for renderers in Go, Rust, Python, Elixir, and Java

---

Current build

Install goresume and just:

# with Go
go install github.com/nikaro/goresume@latest

# with Homebrew
brew install nikaro/tap/goresume just

# on ArchLinux
yay -S goresume-bin just

Generate docs/index.html and serve it locally:

just build    # export resume.yaml -> docs/index.html using the default theme
just serve    # serve docs/ on http://localhost:8000
just go       # build + serve in one step

Validate the resume data:

just validate

Watch for changes and rebuild automatically (requires inotifywait):

just watch

---

Two-page print PDF

The web version at docs/index.html stays long and detailed. The printed, ATS-oriented PDF is constrained to two pages: single-column layout, no tag chips, plain-text contact URLs, the Profile hidden behind a flag, and several roles consolidated in print via the printDates / mergePrintPrev / condensePrint fields in resume.yaml. The --since filter drops roles that ended before the given date (here the three-month MICROS role).

Requires a Chromium/Chrome binary on PATH (used headless for PDF export).

just go-print

Or run the full command directly:

cd go
go build -o resume-renderer .
./resume-renderer \
  --input ../resume.yaml \
  --output ../output/resume-print.html \
  --pdf ../output/resume.pdf \
  --since 2011-05-01

Add --no-profile to omit the Profile/summary section.

---

Themes

The themes/ directory contains alternate HTML layouts ported from FRESH Resume themes. Pass a theme name to just build to use one:

just build block           # default
just build positive
just build simple
just build simple-compact
just build actual

---

GitHub Pages

docs/index.html is committed to the repository. GitHub Pages is configured to serve from the docs/ folder on the master branch - no CI build step is required. Regenerate and commit docs/index.html whenever resume.yaml changes.

---

Planned renderers

Self-contained renderers in Go, Rust, Python, Elixir, and Java are in development. Each will read resume.yaml directly (no goresume dependency) and write docs/index.html. Implementation plans are in plans/.