Create online CV with Jekyll

One of my first Jekyll sites was my resume available online. While many HRs and recruiters still prefer the classic PDF, I decided to give the online thing a try. After all, it’s so easy just to send the link to your CV. In this article, I will show you how to create your online CV using Jekyll as a static site generator and Vercel for deploying and hosting your site.

Our goal is to build and publish the one-page online resume site using Jekyll and Vercel. The end result will look like this:


Assume that you have Jekyll, Git client, and Visual Studio Code editor installed on your computer. If not, read the Jekyll article first.

To check that you have Jekyll installed:

  1. Open Command Prompt.


  2. Enter jekyll -v and press Enter.


To check that you have Git and VSCode installed:

  1. In the Command Prompt, enter git --version.


  2. Check that you have Visual Studio Code installed.


Download the theme

There are a lot of free preconfigured Jekyll themes that you can download from GitHub. You can view the list of themes for static site generators at JAMstack Themes. I used this theme for my online resume.

To download the Jekyll theme for your online resume:

  1. Go to the theme GitHub repository.

  2. Select Code.

  3. Select Download ZIP.


  4. Save the zipped project folder to your computer.

  5. Unzip the folder.

Launch the site locally

Before changing the data in this CV, let’s check how the site runs locally on your computer.

Edit the config file

To edit the _config.yml file:

  1. Open the project folder in VSCode.

  2. Select the _config.yml file.


  3. Delete the line: baseurl: '/online-cv' #change it according to your repository name.

  4. Delete the lines under the # Development Settings.

    port: 4000
    safe: false

This is how your _config.yml file should look.


Install Bundler

To install the Bundler:

  1. In the file explorer, copy the path to the project folder.

    In my case, it’s c:\Users\ivanc\online-cv-master


  2. In the Command Prompt, change the directory to your project folder path. Press Enter.

    cd c:\Users\ivanc\online-cv-master\

  3. Enter gem install bundler and press Enter.

  4. Enter the following commands:

    bundle init
    bundle install


    These commands created new Gemfile files in your project folder.

  5. Open the Gemfile with Notepad.


  6. Delete everything in this file.

  7. Enter the following data and save the file.

    source ""
    gem "jekyll"


Build the site

To build your Jekyll site locally:

  1. Enter jekyll serve and press Enter.


  2. Copy the server address:

  3. Paste it in your browser and you should see your site served locally.


Edit your resume

Now that you’ve built the resume site, it’s time to edit its data with your own.

To edit the data in your resume:

  1. In VSCode, open the project folder and select the data.yml file.


  2. Edit the data in the resume with your own.

Publish the site online

When you finish editing the site locally, it’s time to publish it online for everybody to see. For this example, I will use another nice platform to deploy and host your site, Vercel. But first you need to upload your project folder to GitHub.

Publish to GitHub

To upload your project folder to GitHub:

  1. In VSCode, open the project folder.

  2. Select the Source Control icon.


  3. Select Publish to GitHub.

  4. Select Publish to GitHub public repository.


    When the project folder has been uploaded to the GitHub repository, you will see this success message.


  5. Select Open in GitHub to view your project folder uploaded and synced to the GitHub repository.


Deploy to Vercel

To publish your site online, you need to deploy it to Vercel.

  1. Go to Vercel.

  2. Select Continue with GitHub.


  3. Select Import Project.


  4. Select Continue to import your project from GitHub.


  5. Provide the link to your GitHub repository and select Continue:


  6. Enter the project name: for example, online-cv-master. Select Deploy.


    When the deploy finishes you will see this nice success screen.


  7. Select Visit to go to your resume site available online.

    You should see your site similar to this:

Last modified March 9, 2023: added redoc api article (f99a6e6)