Skip to content

jsonresume/resume-cli

Repository files navigation

resume-cli

matrix Build status npm package

This is the command line tool for JSON Resume, the open-source initiative to create a JSON-based standard for resumes.

Project Status

This repository is not actively maintained. It's recommended to use one of the third-party clients that support the JSON Resume standard instead:

Getting Started

Install the command-line tool:

npm install -g resume-cli

Usage

Commands at a Glance

Command Description
init Initialize a resume.json file.
validate Schema validation test your resume.json.
export path/to/file.html Export to .html.
serve Serve resume at http://localhost:4000/.

resume --help

Show a list of options and commands for the CLI.

resume init

Creates a new resume.json file in your current working directory.

Complete the resume.json with your text editor. Be sure to follow the schema (available at https://jsonresume.org/schema/).

resume validate

Validates your resume.json against our schema to ensure it complies with the standard. Tries to identify where any errors may be occurring.

resume export [fileName]

Exports your resume in a stylized HTML or PDF format.

A list of available themes can be found here:
https://jsonresume.org/themes/

Please npm install the theme you wish to use before attempting to export it.

Options:

  • --format <file type> Example: --format pdf
  • --theme <name> Example: --theme even

resume serve

Starts a web server that serves your local resume.json. It will live reload when you make changes to your resume.json.

Options:

  • --port <port>
  • --theme <name>

When developing themes, change into your theme directory and run resume serve --theme ., which tells it to run the local folder as the specified theme.

This is not intended for production use, it's a convenience for theme development or to visualize changes to your resume while editing it.

Supported Resume Input Types

  • json: via JSON.parse.
  • yaml: via yaml-js
  • quaff: if --resume is a directory, then the path is passed to quaff and the resulting json is used as the resume. quaff supports a variety of formats in the directory, including javascript modules.

Resume Data

  • Setting --resume - tells the CLI to read resume data from standard input (STDIN), and defaults --type to application/json.
  • Setting --resume <path> reads resume data from path.
  • Leaving --resume unset defaults to reading from resume.json on the current working directory.

Resume MIME Types

Supported resume data MIME types are:

  • application/json
  • text/yaml

License

Available under the MIT license.