Skip to content

cntrvsy/resume-pipeline

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

104 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Resume Pipeline

PR: not welcome fork: welcome

A Terminal User Interface (TUI) application built with Ratatui for generating tailored resumes from YAML data sources. Exports professional PDFs using Typst.

resume_pipeline_vid

🚀 Quick Start

Installation

  1. Download the latest binary and resume-data.zip from Releases.
  2. Unzip resume-data.zip into the same directory as the executable.
  3. Run the executable:
    ./resume-pipeline

Building from Source

git clone https://github.com/cntrvsy/resume-pipeline
cd resume-pipeline
cargo run --release

✨ Features

  • Granular Control: Toggle individual bullet points and sections on the fly.
  • Dynamic Profiles: Quickly switch between multiple job titles and summaries.
  • YAML Driven: Maintain your resume data in simple, version-controllable YAML files.
  • Typst Integration: High-quality PDF generation via custom templates.
  • Privacy First: Selectively omit phone numbers or emails directly from the UI.

⌨️ Keyboard Shortcuts

Key Action
Enter Proceed / Generate PDF
Backspace Previous screen
Space Toggle item inclusion
j / k or / Navigate selection
e / Drill down into experience bullets
e / p Toggle Email / Phone (Profile screen)
q Quit

📂 Project Structure

.
├── data/
│   ├── profile.yaml      # Personal info
│   ├── experience.yaml   # Work history (toggable bullets)
│   ├── jobtitles.yaml    # Titles & summaries
│   └── templates/        # Typst (.typ) templates
├── output/               # Generated PDFs
└── src/                  # Rust source code

🔧 Customization

  1. Data: Edit the YAML files in data/ to update your info. Keep the existing structure.
  2. Template: Modify data/templates/default_resume_template.typ to change the PDF layout. The template receives filtered data via sys.inputs.

🛠 Troubleshooting

  • Missing Files: Ensure the data/ folder is in the same directory as the binary.
  • YAML Errors: Validate your YAML syntax if the app fails to load data.
  • PDF Fails: Check the TUI error screen for Typst compilation messages.

📄 License

MIT © 2026 frstudios.co.ke. Forking is welcome; pull requests are not currently accepted.

About

a terminal app for windows, mac and linux to create standardized resumes from YAML files straight to pdf

Resources

License

Stars

59 stars

Watchers

0 watching

Forks

Sponsor this project

Packages

 
 
 

Contributors