Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/developerpaul123/modern-cv

A modern resume template written in Typst, inspired by Awesome-CV
https://github.com/developerpaul123/modern-cv

awesome-cv clean cover-letter cover-letter-template cover-letter-templates cv modern resume resume-template resume-templates typst typst-cv typst-template

Last synced: about 1 month ago
JSON representation

A modern resume template written in Typst, inspired by Awesome-CV

Host: GitHub
URL: https://github.com/developerpaul123/modern-cv
Owner: DeveloperPaul123
License: other
Created: 2024-03-22T21:05:34.000Z (9 months ago)
Default Branch: main
Last Pushed: 2024-11-01T16:25:10.000Z (about 2 months ago)
Last Synced: 2024-11-01T17:18:56.070Z (about 2 months ago)
Topics: awesome-cv, clean, cover-letter, cover-letter-template, cover-letter-templates, cv, modern, resume, resume-template, resume-templates, typst, typst-cv, typst-template
Language: Typst
Homepage: https://typst.app/universe/package/modern-cv
Size: 4.05 MB
Stars: 235
Watchers: 3
Forks: 46
Open Issues: 3
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # Modern CV

[![say thanks](https://img.shields.io/badge/Say%20Thanks-👍-1EAEDB.svg)](https://github.com/DeveloperPaul123/modern-cv/stargazers)

[![Discord](https://img.shields.io/discord/652515194572111872?logo=Discord)](https://discord.gg/CX2ybByRnt)

![Release](https://img.shields.io/github/v/release/DeveloperPaul123/modern-cv)

[![Tests](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/tests.yml/badge.svg)](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/tests.yml)  

A port of the [Awesome-CV](https://github.com/posquit0/Awesome-CV) Latex resume template in [typst](https://github.com/typst/typst).

## Requirements

### Tools

The following tools are used for the development of this template:

- [typst](https://github.com/typst/typst)

- [typst-test](https://github.com/tingerrr/typst-test) for running tests

- [just](https://github.com/casey/just) for simplifying command running

- [oxipng](https://github.com/shssoichiro/oxipng) for compressing thumbnails used in the README

### Fonts

You will need the `Roboto` and `Source Sans Pro` fonts installed on your system or available somewhere. If you are using the `typst` web app, no further action is necessary. You can download them from the following links:

- [Roboto](https://fonts.google.com/specimen/Roboto)

- [Source Sans Pro](https://github.com/adobe-fonts/source-sans-pro)

This template also uses FontAwesome icons via the [fontawesome](https://typst.app/universe/package/fontawesome) package. You will need to install the fontawesome fonts on your system or configure the `typst` web app to use them. You can download fontawesome [here](https://fontawesome.com/download).

To use the fontawesome icons in the web app, add a `fonts` folder to your project and upload the `otf` files from the fontawesome download to this folder like so:

![alt text](assets/images/typst_web_editor.png)

See `typst fonts --help` for more information on configuring fonts for `typst` that are not installed on your system.

### Usage

Below is a basic example for a simple resume:

```typst

#import "@preview/modern-cv:0.7.0": *

#show: resume.with(

  author: (

      firstname: "John", 

      lastname: "Smith",

      email: "[email protected]", 

      phone: "(+1) 111-111-1111",

      github: "DeveloperPaul123",

      linkedin: "Example",

      address: "111 Example St. Example City, EX 11111",

      positions: (

        "Software Engineer",

        "Software Architect"

      )

  ),

  date: datetime.today().display()

)

= Education

#resume-entry(

  title: "Example University",

  location: "B.S. in Computer Science",

  date: "August 2014 - May 2019",

  description: "Example"

)

#resume-item[

  - #lorem(20)

  - #lorem(15)

  - #lorem(25)  

]

```

After saving to a `*.typ` file, compile your resume using the following command:

```bash

typst compile resume.typ

```

For more information on how to use and compile `typst` files, see the [official documentation](https://typst.app/docs).

Documentation for this template is published with each commit. See the attached PDF on each Github Action run [here](https://github.com/DeveloperPaul123/modern-cv/actions).

### Output Examples

| Resumes | Cover letters |

| --- | --- |

| ![Resume](assets/images/resume.png) | ![Cover Letter](assets/images/coverletter.png) |

| ![Resume 2](assets/images/resume2.png) | ![Cover Letter 2](assets/images/coverletter2.png)|

## Building and Testing Locally

To build and test the project locally, you will need to install the `typst` CLI. You can find instructions on how to do this [here](https://github.com/typst/typst#installation).

With typst installed you can make changes to `lib.typ` and then `just install` or `just install-preview` to install the package locally. Change the import statements in the template files to point to the local package (if needed):

```typst

#import "@local/modern-cv:0.6.0": *

````

If you use `just install-preview` you will only need to update the version number to match `typst.toml`.

Note that the script parses the `typst.toml` to determine the version number and the folder the local files are installed to.

### Formatting

This project uses [typstyle](https://github.com/Enter-tainer/typstyle) to format the code. Run `just format` to format all the `*.typ` files in the project. Be sure to install `typstyle` before running the script.

## License

The project is licensed under the MIT license. See [LICENSE](LICENSE) for more details.

## Author

| [
_{@DeveloperPaul123}](https://github.com/DeveloperPaul123) |

|:----:|