mintyfrankie / brilliant-cv

💼 another CV template for your job application, yet powered by Typst and more

Brilliant CV

The Brilliant CV project is still under preview, just like Typst is, so use with caution as future updates might break your current production.

Read commits and changelog should you find new patches are not working, and feel free to lock to a working release & submit issues or PRs, I am happy to help!

Brilliant CV is a Typst template for making Résume, CV or Cover Letter inspired by the famous LaTeX CV template Awesome-CV.

Features

• Separation of style and content: version control your CV entries in the modules folder, without touching the styling and typesetting of your CV / Cover Letter (hey, I am not talking about Macrohard Word, you know)
• Quick twitches on the visual: add company logos, put your shiny company name or your coolest title at the first line globally or per-document needs
• Multilingual support: centrally store your multilingual CVs (English + French + German + Chinese + Japanese if you are superb) and change output language in a blink
• (NEW) AI Prompt and Keywords Injection: Fight against the abuse of ATS system or GenAI screening by injecting invisible AI prompt or keyword list automatically.

Preview

CV	Cover Letter

CV (French, red, no photo)	Cover Letter (French, red)

CV (Chinese, green)	Cover Letter (Chinese, green)

Usage

Installation

You can either directly create a new repository by using this template, or you might want to add the submodule repository and build up your own Typst project.

Method 1: Jumpstart by clicking Use this template and create your own CV repository

When compiling, use:

typst compile ./cv.typ ./output/CV.pdf --font-path ./src/fonts/

Method 2: Add the submodule repository to your existing project

cd your/CV/project
git submodule add https://github.com/mintyfrankie/brilliant-CV-Submodule brilliant-CV
typst compile cv.typ

When you want to get new features from the updated template module:

git submodule update --remote

Tips

• metadata.typ should live in the project root folder, and by changing the variables in it, you can quickly adjust language or display settings of the documents.
• Make sure when you build a multilingual module (./modules_fr for example) you are quoting the right language variable in the metadata.typ (fr in this case).

Project Structure

|
|-- modules/          --> sections of your CV
|   |- *.typ
|
|-- modules_*         --> multilingual sections of your CV
|
|-- brilliant-CV/
|   |- template.typ   --> the template file
|   |- metadata-demo.typ -> the example metadata file
|
|-- src/
|   |- fonts/         --> local font files
|   |- logos/         --> logos for your cvEntry
|   |- *.png          --> images used in the documents
|   |- *.bib          --> BibTeX file for Publications section
|
|-- cv.typ          --> CV file
|-- letter.typ      --> Cover Letter file
|-- metadata.typ    --> Personal Infos & Settings

Current Issues

As Typst is still a very young (although very promising and robust to my belief) project, some features are only partially supported on certain platforms. It is hence difficult to predict any anomalies, but you are definitely welcomed to bring a PR, an issue or a discussion!

• Image cropping: Typst does not have direct support to crop images using native primitives. Bring your own cropped image for profile photo if needed.
• Publications Section: Current version of Typst does not allow full customization on the #bibliography function, so the display of publication section might not be optimal. See this disucssion.

Credit

• Typst is a newborn, open source and simple typesetting engine that offers a better scripting experience than LaTeX.
• Awesome-CV is the original LaTeX CV template from which this project is heavily inspired. Thanks posquit0 for your excellent work!

brilliant-cv's Issues

Source Sans Pro TTF files do not include Smallcaps

Describe the bug
When rendering the project with the included fonts at src/fonts, the output does not show the smallcaps as it is the case in the screenshots.

To Reproduce

1. Clone Repository
2. build with just compile-cv
3. Inspect PDF

Expected behavior
Societies and Footer to be rendered in SmallCaps

Possible Fix
It seems that Adobe included SmallCaps only in the OpenType version of the Fonts, not the TrueType versions.
Adding the OTF files from https://github.com/adobe-fonts/source-sans to the src/fonts directory and changing the font in template.typ to "Source Sans 3" leads to an output with correctly rendered SmallCaps - while everything else looks the same (at least on my machine)

Request for Guidance: Achieving Formatting Consistency with the Example CV in README

I am sorry I didn't clarify my problem in the previous issue
I'm currently working with the project in this repository and I'm trying to format the output CV so that it resembles the formatting of the Example French CV presented in the README file.

Currently the result seems to use different font, is this because I dont have installed the fonts mentioned in the layout section in the template?

Compile with a multilanguage module

It is possible to create multiple modules directories for each language like modules_fr in this repo. When I compile the CV, the main modules directory is used to produce english document. How can I specify the language to compile my CV to another language?

Set before*Skip variable from top cv.typ file

Hi,
I would like to override beforeSectionSkip, beforeEntrySkip and beforeEntryDescriptionSkip variables defined in awesomeCV/template.typ.

Is it possible to do this without editing the template.typ file (do this from cv.typ file)?

Thank you.

fa icons not working

Describe the bug
just seems that fa icons are not working for me, probably there is a super easy way to install them, just no idea how to do it also I don´t find any infomation on how to do it.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
Icons work

Screenshots

Additional context
Add any other context about the problem here.

update project section to include github link

please can we have something like this for projects so when we click the link we are redirected to source code

live version Switching

Is your feature request related to a problem? Please describe.
Mostly, if I updated my CV, I would like to update all languages and compile them all.

Switch behavior by source editing seems unnatural

Describe the solution you'd like
Pass the desired languages by cmdline args, or change the varLanguage into a list

Describe alternatives you've considered
Furthermore. It feels more reasonable to nast the language entry in the file i.e. like the metadata.typ

---

I realize that it is a language limitation that each compile can only output one PDF. and also if the cmdline can pass args to the template

Better split of personal info data into 2 lines

Currently, when I added field in my adress the personal info splitted into 2 lines.
What dosn't working is that the split doesn't work as expected.
Instead of moving whole item into new line, the icon stay in the first line but the content move to new one.

generated with this code

#let personalInfo = (
      adress: "1234 Elm Street, Fictionville, ST 12345",
        phone: "[phone]",
  email: "[email protected] ",
  github: "testUser12345",
  linkedin: "testUser12345",
  //gitlab: "mintyfrankie",
  homepage: "testUser12345.me",
  //orcid: "0000-0000-0000-0000",
  //researchgate: "John-Doe",
)

I would expected that the github icon will go int second line.
Also I try force new line by hand with "" but it created error inside this typst environment.

typst doesnt process correctly the content

I download the repo and try to compile one of the document

cd modules_fr && quarto typst compile MyCV.typ

Ther result is below

I am on MacOS 13.4.1, typst 0.6.0

Git clone not working properly

This should fix cloning the repo with submodules

git clone --recurse-submodules -j8 [email protected]:mintyfrankie/awesomeCV-Typst.git

source: https://stackoverflow.com/a/4438292/10491422

Ability to omit `headerQuoteInternational`

Is your feature request related to a problem? Please describe.
If headerQuoteInternational is left empty, the space that it takes is left blank instead of being occupied by the content that follows.

Describe the solution you'd like
The vertical spacing should adjust automatically if a header quote is not provided (or empty).

Is the CV ats Parseable