jsonresume-theme-stackoverflowed
A JSON Resume Theme inspired by the Stack Overflow Developer Story resume format.
Motivation
Sadly the Stack Overflow team decided to discontinue the Jobs and Developer Story platform on March 31, 2022. Having had much career success particularly thanks to their product this came as disappointing news - there is something about this resume format that seems to translate well with recruiters, so with a little artistic license this project aims to create a faithful replica that is compatible with the Resume CLI tool.
Sample
Getting Started
Start a new project and install the following dependencies.
npm install resume-cli jsonresume-theme-stackoverflowed
Optionally generate some sample data if not starting with an existing resume.
npx resume init
Add some workflow scripts to the package.json
{
"scripts": {
"validate": "resume validate --resume ./resume.json",
"serve": "resume serve --resume ./resume.json --theme stackoverflowed",
"export": "resume export --resume ./resume.json --theme stackoverflowed",
"pdf": "$npm_execpath run export -- --format pdf \"./$(date +'%Y-%m-%d').pdf\"",
"html": "$npm_execpath run export -- --format html \"./$(date +'%Y-%m-%d').html\""
}
}
Happy job hunting...
npm run <script>
⚠️ Windows users: the resume-cli tool and puppeteer combo is difficult to get running in WSL and not reliable when generating PDFs - A linux virtual machine is recommended in this case.
Environment Configuration
StackExchange
This theme can make requests to fetch a short summary of contributor activity that will be displayed
underneath a StackOverflow profile entry when a valid url
is specified. By default this behaviour
is switched off due to the API throttling, limiting anonymous requests to 300 per day. However this
should be okay for occasional use and can be explicitly enabled by setting the key to anon
.
STACK_EXCHANGE_API_KEY=anon
STACK_EXCHANGE_ACCESS_TOKEN=
Resume Configuration
The JSON Resume schema allows space for arbitrary meta data. This theme will consume a custom configuration from JSON defined under the following namespace, all further parameters listed on this page will assume that they are configured at this level. For the avoidance of doubt a sample configuration is available, which matches the default values if otherwise unspecified.
{
"meta": {
"theme-stackoverflowed": {
/* configuration */
}
}
}
Localisation
{
"locale": string
}
locale
— string
A language (e.g. en
) or regional variant (e.g. en-GB
) that will localise dates
and text content.
- defaults to
en-US
Formatting
{
"format": {
"date": string,
"location": string | string[]
}
}
format.date
— string
A date-fns
format for rendering dates.
format.location
— string
| string[]
A template or list of templates (fallbacks) that will be passed the values of basics.location
from the resume - interpolated keys use the syntax {{var}}
. In addition to the schema properties,
the following keys are also available.
Key | Description |
---|---|
countryNameAlias |
A colloquial name resolved from the countryCode . |
countryNameOfficial |
A full country title resolved from the countryCode . |
If it is preferable to split an address across multiple lines, this can be achieved by inserting a newline character in the template - note that this needs to be doubly escaped to be valid JSON.
{
"format": {
"location": "{{address}}, {{postalCode}} \\n {{city}}, {{region}}"
}
}
Introduction
{
"intro": {
"avatar": {
"align": string,
"hidden": boolean
}
}
}
intro.avatar.align
— string
— "left"
| "right"
By default the avatar will align to the right
of the address and contact details - however can
be configured to align to the left
of the name and title.
intro.avatar.hidden
— boolean
All resume data will be displayed by default, where content exists - if a profile image
is not
available, then this theme will lookup a Gravatar for the email
listed under the
basics
profile data. However if it is preferable to hide a profile image then the hidden
option
can be set to true
.
Sections
{
"section": {
[string]: {
"order": number
"break": boolean
"hidden": boolean
}
}
}
Sections map directly to resume schema fields and the currently supported names are: skills
| work
| volunteer
| projects
| education
| awards
|
publications
| languages
| interests
| profiles
| references
.
Sections are only rendered if there is sufficient data for each in a given resume.
section.<name>.order
— number
Sections are by default laid out with the same priority as stated above - each section relevant to a resume will be assigned a number (starting from 1). This may be overridden on a per-section basis to customise the order.
section.<name>.break
— boolean
Sometimes a page break may split a section in an awkward place - this is difficult to compensate
for programmatically given the unknown nature of the configuration and / or data being rendered.
As such, this escape hatch allows a section to force a page break (above) by setting it to true
.
section.<name>.hidden
— boolean
If it is preferable to maintain data in a resume but not have it rendered, a section can be
disabled by setting this to true
.