Skip to content

Releases: xGoldy/lucidcv

Release list

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 07 Oct 13:40

The first public release of Lucid CV, a LuaLaTeX class for modern resumes that stay readable for Applicant Tracking Systems (ATSs) and PDF text extractors. The design is inspired by PlushCV; the back-end is built and tested around what extractors actually return.

Highlights

  • Tested ATS compatibility. A test suite checks every phrase of a resume against 9 PDF/OCR engines in 13 configurations, including Poppler, MuPDF, PDFium, pdf.js, PDFBox and Tesseract OCR. The one-column variants extract completely and in document order in all 12 text-layer configurations. See the latest test report.
  • PDF/A-2b and tagged PDF. Validated with veraPDF. Headings are tagged as H2/H3, the photo is a Figure with alternative text, and the title, author and subject are filled in from the header.
  • Parser-friendly typesetting.
    • Word gaps are stored as real space characters.
    • Icons extract as plain whitespace, never as stray letters.
    • Contact values carry their full prefix, such as github.com/you.
    • Right-aligned dates are tied to their entries by a dotted leader.
    • Skill chips are tuned to survive OCR.
  • One content file, several layouts. The same body is typeset in one or two columns, at regular or compressed density, by changing class options only.
  • Customizable from the preamble. Accent color, margins, column ratio, font sizes and spacing can all be changed without editing the class.
  • Header and entries.
    • Predefined contact fields: email, phone, address, location, homepage, LinkedIn, GitHub and ORCID. You can also add custom fields with their own icons.
    • Optional circular photo.
    • Entries can be stacked or on one line, and can be grouped as sub-entries, such as several positions at one company.
    • Skill chips, reference entries, dashed dividers and a Last update timestamp.

What's in lucidcv.zip

  • lucidcv.cls: the class
  • main.tex and contents.tex: a complete sample resume that uses every body macro, with comments
  • lucidcv-sample.pdf: the compiled sample
  • lucidcv-doc.pdf and README.md: the documentation
  • fonts/: Inter, Source Sans 3, and Source Code Pro (SIL Open Font License)
  • photo.jpg, latexmkrc and LICENSE

The test suite, build.sh and the extended documentation in resources/ are only in the repository, not in the zip. Clone the repository to run the ATS tests yourself.

Requirements

LuaLaTeX with a LaTeX format of 2026-06-01 or newer (TeX Live 2026 with current updates). An older format compiles with a warning, but lists may get extra vertical space.

Getting started

  • Overleaf: open the shared template, make a copy and set the compiler to LuaLaTeX.
  • Locally: unzip the package and run latexmk main.tex, or download the build.sh script by cloning the repository.

The README covers all class options, commands and macros.

License

  • The LaTeX sources and documentation are under the LPPL 1.3c.
  • The test suite and accompanied scripts are under the MIT License.
  • The bundled fonts are under the SIL Open Font License.