JSON Resume

repository·master·Indexed 42 days ago

https://github.com/jsonresume/jsonresume.org

An open-source ecosystem providing a standardized JSON format for resumes, including tools for creation, validation, rendering, and publishing. Features include an AI-powered job matching system called Decisions, an ATS compatibility scoring engine via the calculateATSScore function and /api/ats endpoint, and a registry for managing resume data.

Tokens
414.6K
Snippets
1.2K
Records
1.7K
Agent score
56%

What's inside JSON Resume

  1. Overview of the JSON Resume platform

    master

    The JSON Resume platform is a modular ecosystem for managing, analyzing, and visualizing professional resumes and job data. It provides tools for resume parsing, ATS (Applicant Tracking System) analysis, job matching via AI-driven decision trees, interactive job graph visualization, mock interview facilitation, and automated cover letter generation.

    Core Ecosystem Packages

    • @jsonresume/schema (npm: packages/schema): The canonical JSON Resume schema and validator.
    • resume-cli (npm: packages/cli): The command-line tool for managing resumes.
    • json-resume-serde (npm: packages/core-rust): A Rust implementation of the schema.
    • @jsonresume/ats-validator (npm: packages/ats-validator): Tools for validating resumes against ATS standards.
    • @jsonresume/resume-core (npm: packages/resume-core): Shared resume components.
    • @jsonresume/ui (npm: packages/ui): The shared UI library.
    • @jsonresume/jobs (npm: packages/job-search): HN job-search CLI.
    • Themes: Approximately 52 themes available in packages/themes/.
  2. Overview of the Resume Core Library

    master
    The Resume Core Library is a collection of React components, design tokens, and utilities designed to build ATS-friendly, visually appealing resume themes. It provides modular subsystems for typography, layouts, skills, timelines, profile sections, and more. The library emphasizes semantic HTML, accessibility, print optimization, and internationalization.
  3. Overview of Tokyo Modernist design and features

    master

    Tokyo Modernist is a minimal, futuristic JSON Resume theme built on an 8pt grid system. It combines geometric precision with expressive typography, making it suitable for design studios and modern engineering firms.

    Key Design Characteristics

    • Typography: Uses the Outfit variable-width geometric sans serif. Features strong uppercase headings with negative letter-spacing.
    • Color Palette: Uses a near-black (#1a1d23) primary text, deep magenta (#c71585) accents, and various gray tones for subheaders and body text on an off-white (#fafbfc) background.
    • Layout: Employs an 8px grid-based spacing system for perfect alignment and uses asymmetric elements like triangular accents and diamond bullets.
    • Optimization: The theme is responsive for mobile viewing and print-optimized for PDF generation.
  4. Overview of the University First theme

    master

    The university-first theme is a professional, student-oriented resume theme designed specifically for recent graduates and early-career applicants. It follows an 'Education-First' layout where academic credentials are prioritized over work experience.

    Key Characteristics:

    • Layout: Single column, ATS-friendly, and white background.
    • Typography: Uses Inter (humanist sans-serif) for body text at 11pt, with serif fonts for institution names to emphasize academic credentials.
    • Color Palette: Uses a professional 'School Blue' accent (#2563eb).
    • Section Support: Supports all 12 standard JSON Resume sections.
  5. Overview of the Operations Precision theme

    master

    The Operations Precision theme is a JSON Resume theme designed for operations professionals, systems thinkers, and process-oriented individuals. It features a clean, efficient, single-column layout optimized for readability and professional presentation.

    Key Characteristics

    • Vibe: Efficient, dependable, and systems-oriented.
    • Layout: Single column with a maximum width of 850px.
    • Typography: Uses the Inter sans-serif font with a 15px body size and uppercase section titles.
    • Color Palette: Features a teal accent (#0f766e) with near-black headings (#111827) and dark gray body text (#4b5563).
    • Print-Optimized: Designed to print beautifully with controlled page breaks to prevent sections from splitting across pages.
  6. Overview of the API Layer

    master

    The API Layer provides backend route handlers and utility functions for core features including authentication, resume management, job matching, pathways, chat interactions, and report generation. It orchestrates data flow between client requests, Supabase (for data storage), and OpenAI (for AI-driven text generation and embeddings).

    Route handlers are organized by domain, such as /api/jobs, /api/resumes, and /api/pathways.

  7. Overview of the Pathways Feature

    master

    Pathways is an AI-powered career coaching feature within the JSON Resume ecosystem. It provides a suite of tools for interactive career management, including:

    • Conversational Resume Editing: Use GPT-4.1 to modify your resume via chat (e.g., "Add my job at Microsoft as a Senior Engineer").
    • Visual Job Exploration: An interactive graph visualization of matching jobs using ReactFlow.
    • Voice Interaction: Hands-free usage supported by OpenAI Text-to-Speech (TTS) and voice transcription.
    • Resume Parsing: Support for uploading PDF, DOC, DOCX, TXT, and image files to automatically generate a resume JSON.
  8. Overview of available JSON Resume themes

    master

    JSON Resume supports a wide variety of themes, each with distinct architectural approaches and visual styles. Themes are typically implemented as React components using styled-components or utility-first frameworks like Tailwind CSS.

    Common architectural patterns include:

    • Styled-components: Used by most themes (e.g., Urban Techno, Tokyo Modernist, Professional) for layout and typography.
    • Tailwind CSS: Used by the Tailwind Theme via twind for SSR-compatible utility styling.
    • Metric-focused: Themes like Investor Brief and Data-Driven calculate and display key metrics (e.g., total years of experience, skill counts) derived from the resume data.
    • Niche-specific: Themes tailored for specific roles, such as Government Standard (grayscale, formal), Developer Mono (monospace, technical), and Marketing Narrative (story-driven).
  9. Overview of the Hacker News Job Processing Pipeline

    master

    The Hacker News Job Processing Pipeline is an automated system designed to scrape, process, and index job postings from Hacker News "Who is Hiring?" threads.

    The pipeline follows a three-step architecture:

    1. Scraping: Fetches the latest threads and extracts raw job postings from comments.
    2. AI Processing: Uses OpenAI GPT-5-mini to parse job descriptions into structured JSON, enriches company data, and generates human-readable summaries.
    3. Vectorization: Generates semantic embeddings using OpenAI text-embedding-3-large to enable semantic search (e.g., matching resumes to jobs).

    Data is stored in Supabase (PostgreSQL) and Pinecone for vector search.

  10. Overview of the Consultant Polished theme

    master

    The Consultant Polished theme is an elegant, structured JSON Resume theme designed for narrative-driven consulting, strategy, and advisory roles. It follows a design philosophy similar to a professional consulting deck: sophisticated, restrained, and balanced.

    Key Features

    • Layout: Single column layout with clear section spacing for easy scanning.
    • Typography: Uses transitional serif headers (e.g., Georgia, Times New Roman) paired with a modern sans-serif body for readability.
    • Color Palette: Features a navy accent color (#0b1f3a) for professional sophistication.
    • Optimization: Print-optimized and ready for PDF export.
  11. Overview of the Resume Company Enrichment System

    master

    The Resume Company Enrichment System is an automated pipeline designed to extract company names from resumes and enrich them with detailed dossiers using Perplexity AI.

    The workflow follows these steps:

    1. Extraction: Unique companies are extracted from resumes in the database and tracked in a resume_companies table.
    2. Tracking: The system uses a dedicated table to manage company names, normalization, and enrichment status.
    3. Enrichment: Companies are enriched with Perplexity AI to generate dossiers (industry, size, business model, etc.).
    4. Maintenance: Data is refreshed yearly to ensure accuracy, and the system avoids duplicate API calls by using normalized names and unique constraints.
  12. Overview of the Government Standard Theme

    master

    The Government Standard theme is a formal, conservative JSON Resume theme specifically designed for roles in government, defense, compliance, and civil service. It prioritizes document clarity and ATS (Applicant Tracking System) compatibility over visual aesthetics.

    Key Characteristics

    • Layout: Ultra-traditional single-column layout with clear section separations.
    • Compliance: Grayscale-only color palette (black, dark gray, white) to ensure maximum professionalism and ATS optimization.
    • Print-Ready: Configured with proper margins and page breaks for physical document printing.
    • Typography: Uses formal serif fonts (Times New Roman or Georgia) with 12pt body text.