Skip to content

A modern application to generate professional, ATS-compliant PDF resumes effortlessly from user-provided YAML data. Create resumes in minutes with dynamic templates, customizable icons, and multi-column layouts.

License

Notifications You must be signed in to change notification settings

aafre/resume-builder

Repository files navigation

Tests and Coverage Build Status License

Resume/CV Builder 🛠️

Create Professional Résumés with Ease 🚀

Table of Contents


Try It Online

Generate your resume instantly:

  1. Download a Sample Template.
  2. Edit it with your details.
  3. Upload it at easyfreeresume.com.

React UI (Development)

The React UI for creating, editing, and updating resumes is available at dev.easyfreeresume.com. Please note that this interface is currently in development and may be unstable. The homepage presently displays dummy data.


Project Overview

Simplify your resume creation process and focus on what matters—your content.

  • Effortless Updates: Edit one YAML file.
  • Modern Designs: Choose from sleek, ATS-friendly templates.
  • Custom PDFs: Instantly generate a polished resume.

Usage Guide

  1. Download a Template:
    Modern Template
  2. Edit Your Details:
    Open the file in any text editor (Notepad, VS Code, etc.) and update your info.
  3. Generate Your Resume:
    Upload your file at easyfreeresume.com.

For more advanced customization, see the YAML Template Guide.


YAML Template Guide

Your resume is defined in a simple YAML file—no coding required!

Example:

- name: Skills
  type: dynamic-column-list
  content:
    - Python
    - Data Analysis
    - Team Management

Supported Types:

  • text: Single-paragraph content.
  • bulleted-list: A list of items.
  • inline-list: Compact, inline list.
  • icon-list: List with optional icons.
  • dynamic-column-list: Auto-adjusting columns.
  • experience: Job history details.
  • education: Academic qualifications.

Customize any section like so:

- name: [Section Name]
  type: [Section Type]
  content:
    - Item 1
    - Item 2

Templates

Available Templates

Modern (No Icons)
YAML: samples/modern/john_doe_no_icon.yml
Modern No Icons

Modern (With Icons)
YAML: samples/modern/john_doe.yml
Modern With Icons

Upcoming Templates

Minimalist (Work in Progress)
Minimalist

Creative (Planned)
YAML: samples/creative_sample.yml (Coming Soon)


Features

  • Dynamic Templates: Multiple ATS-friendly designs.
  • Flexible Customization: Edit your YAML files with ease.
  • Icon & Logo Support: Personalize your resume.
  • Responsive Layouts: Modern, clean formatting.
  • PDF Generation: Download a ready-to-use resume.

Troubleshooting

  • Resume Not Generating?
    Verify that all required fields are filled and your file is in .yaml format.
  • Custom Icons?
    Upload PNG, JPG, or SVG files with your template.
  • Need help? Visit our GitHub Issues.

Getting Started

Quick setup:

git clone https://github.com/aafre/resume-builder.git
cd resume-builder
  • Edit a sample template from the Templates section.
  • Generate your resume:
python resume_generator.py --template modern --input data/sample.yml --output output/resume.pdf

Docker Setup

Build and run using Docker:

docker build -t resume-api -f Dockerfile.dev.api .
docker run -p 5000:5000 resume-api

For the frontend:

cd resume-builder-ui
npm run dev

Contributing

Contributions are welcome! Please submit a pull request or open an issue to help improve this project.