Skip to content
@jsonresume

JSON Resume

A community driven open source initiative to create a JSON based standard for resumes

JSON Resume

An open standard for resumes, written as JSON. Write your resume once as structured data, then render it with any theme, host it at a free URL, validate it, and convert it to other formats. It's portable and has no lock-in. The project has been community-run since 2014.

Get started

Host it online (no install): create a public GitHub Gist named resume.json, then open https://registry.jsonresume.org/<your-github-username>. Choose a theme with {"meta": {"theme": "elegant"}} in the file or ?theme=elegant in the URL.

Work locally with the CLI:

npm install -g resume-cli
resume init        # create a starter resume.json
resume validate    # check it against the schema
resume serve       # preview it in the browser

Where things live

Everything is developed in one repo: jsonresume/jsonresume.org. It contains:

Schema @jsonresume/schema · browse it
CLI resume-cli
Registry (free hosting, 60+ themes) registry.jsonresume.org
Themes gallery jsonresume.org/themes
Docs jsonresume.github.io/jsonresume.org
Converters e.g. @jsonresume/jsonresume-to-rendercv

Also here: mcp, an MCP server that lets your AI coding assistant update your resume as you work.

The older standalone repos (resume-schema, resume-cli, resume-website, …) are archived. Their code now lives in the monorepo.

Get involved

Pinned Loading

  1. jsonresume.org jsonresume.org Public

    The mono repo that builds the homepage, utils, ui components, registry and anything else

    JavaScript 333 68

Repositories

Showing 10 of 32 repositories
  • .github Public

    Org profile and defaults

    jsonresume/.github's past year of commit activity
    0 0 0 0 Updated Oct 20, 2026
  • jsonresume.org Public

    The mono repo that builds the homepage, utils, ui components, registry and anything else

    jsonresume/jsonresume.org's past year of commit activity
    JavaScript 333 MIT 68 55 1 Updated Oct 20, 2026
  • jsonresume-theme-class Public

    A modern theme for JSON Resume which is self-contained. The content of the resume will work offline and can be hosted without depending on or making requests to third-party servers.

    jsonresume/jsonresume-theme-class's past year of commit activity
    JavaScript 34 MIT 12 2 (1 issue needs help) 0 Updated Jun 27, 2026
  • mcp Public

    The registry mcp server updates your resume while you code

    jsonresume/mcp's past year of commit activity
    TypeScript 63 Unlicense 11 1 0 Updated Jun 12, 2026
  • rust-json-resume Public archive

    MOVED to jsonresume/jsonresume.org (packages/core-rust)

    jsonresume/rust-json-resume's past year of commit activity
    Rust 4 MIT 2 0 0 Updated Jun 12, 2026
  • resume-schema Public archive

    MOVED to jsonresume/jsonresume.org (packages/schema) — npm @jsonresume/schema unchanged

    jsonresume/resume-schema's past year of commit activity
    JavaScript 2,388 MIT 292 3 3 Updated Jun 12, 2026
  • resume-cli Public archive

    MOVED to jsonresume/jsonresume.org (packages/cli) — npm 'resume-cli' unchanged, revived for Node 18+

    jsonresume/resume-cli's past year of commit activity
    JavaScript 4,711 MIT 392 6 0 Updated Jun 12, 2026
  • jsonresume Public

    A mono repo

    jsonresume/jsonresume's past year of commit activity
    3 0 0 0 Updated Jun 5, 2026
  • minimalist-portfolio-json Public archive Forked from midudev/minimalist-portfolio-json

    A minimalist portafolio configurable via one JSON

    jsonresume/minimalist-portfolio-json's past year of commit activity
    Astro 3 MIT 419 0 0 Updated Feb 20, 2024
  • registry-functions Public archive

    DEPRECATED - SEE MONO REPO -

    jsonresume/registry-functions's past year of commit activity
    HTML 18 19 2 1 Updated Nov 16, 2023