Fork us on GitHub

Overview

Json Résumé is a community driven open source initiative to create a JSON based standard for résumés. There is no reason why there can't be a common standard for writing a résumé that can be extended with an ecosystem of open source tools. This project will attempt to;

  • Build a community open source movement where everyone can take advantage of the tools
  • Make themeing, exporting, storing and editing résumés super easy

We have researched the alternative standards, and they are a lot more mature but are lacking a modern and friendly ecosystem that empower individuals.

Our goal is to empower developers in every way possible, which means we will stick to a more casual development approach.

Join us on IRC - #jsonresume - Freenode

Why JSON?

We feel that JSON Schema is now mature enough for writing usable schematics. YAML doesn't throughly offer schematic standards yet(though you can easily convert your résumé between YAML and JSON anyway).

Versioning

We will generally do 2 year cycles of revisions to the specification. Though upon release the lifecycle will be short for 3 months whilst last minute revisions are made to the standard

Open Source

Everything on the jsonresume.org domain name is opened source under a MIT license. This is meant to be a community effort to better the JSON résumé ecosystem.


Examples

64x64 64x64

We have built tools for you to initialize and publish your own JSON Resume.

Get Started!

Specification - Version 0.0.0

The JSON resume ecosystem only revolves around major version changes e.g. 0.0.0, 1.0.0, 2.0.0. The smaller changes will be implemented overtime but only major version changes will the ecosystem be expected to follow completely.

{
basics: {
name: string,
label: string, // e.g. Web Developer
picture: string, // URL (as per RFC 3986) to a picture in JPEG or PNG format
email: string, // e.g. [email protected]
phone: string, // Phone numbers are stored as strings so use any format you like, e.g. 712-117-2923
website: string, // URL (as per RFC 3986) to your website, e.g. personal homepage
summary: string, // Write a short 2-3 sentence biography about yourself
location: {
address: string, // To add multiple address lines, use. For example, 1234 Glücklichkeit Straße Hinterhaus 5. Etage li.
postalCode: string,
city: string,
countryCode: string, // code as per ISO-3166-1 ALPHA-2, e.g. US, AU, IN
region: string // The general region where you live. Can be a US state, or a province, for instance.
},
profiles: [{ // Specify any number of social networks that you participate in
network: string, // e.g. Facebook or Twitter
username: string, // e.g. neutralthoughts
url: string // e.g. http://twitter.com/neutralthoughts
}]
},
work: [{
company: string, // e.g. Facebook
position: string, // e.g. Software Engineer
website: string, // e.g. http://facebook.com
startDate: string, // resume.json uses the ISO 8601 date standard e.g. 2014-06-29
endDate: string, // e.g. 2012-06-29
summary: string, // Give an overview of your responsibilities at the company
highlights: [ // Specify multiple accomplishments
string // e.g. Increased profits by 20% from 2011-2012 through viral advertising
]
}],
volunteer: [{
organization: string, // e.g. Facebook
position: string, // e.g. Software Engineer
website: string, // e.g. http://facebook.com
startDate: string, // resume.json uses the ISO 8601 date standard e.g. 2014-06-29
endDate: string, // e.g. 2012-06-29
summary: string, // Give an overview of your responsibilities at the company
highlights: [ // Specify multiple accomplishments
string // e.g. Increased profits by 20% from 2011-2012 through viral advertising
]
}],
education: [{
institution: string, // e.g. Massachusetts Institute of Technology
area: string, // e.g. Arts
studyType: string, // e.g. Bachelor
startDate: string, // e.g. 2014-06-29
endDate: string, // e.g. 2012-06-29
gpa: string, // grade point average, e.g. 3.67/4.0
courses: [ // List notable courses/subjects
string // e.g. H1302 - Introduction to American history
]
}],
awards: [{ // Specify any awards you have received throughout your professional career
title: string, // e.g. One of the 100 greatest minds of the century
date: string, // e.g. 1989-06-12
awarder: string, // e.g. Time Magazine
summary: string // e.g. Received for my work with Quantum Physics
}],
publications: [{ // Specify your publications through your career
name: string, // e.g. The World Wide Web
publisher: string, // e.g. IEEE, Computer Magazine
releaseDate: string, // e.g. 1990-08-01
website: string, // e.g. http://www.computer.org/csdl/mags/co/1996/10/rx069-abs.html
summary: string // Short summary of publication. e.g. Discussion of the World Wide Web, HTTP, HTML.
}],
skills: [{ // List out your professional skill-set
name: string, // e.g. Web Development
level: string, // e.g. Master
keywords: [ // List some keywords pertaining to this skill
string // e.g. HTML
]
}],
languages: [{ // List any other languages you speak
language: string, // e.g. English, Spanish
fluency: string // e.g. Fluent, Beginner
}],
interests: [{
name: string, // e.g. Philosophy
keywords: [
string // e.g. Friedrich Nietzsche
]
}],
references: [{ // List references you have received
name: string, // e.g. Timothy Cook
reference: string // e.g. Joe blogs was a great employee, who turned up to work at least once a week. He exceeded my expectations when it came to doing nothing.
}]
}