Summary

JSON Resume provides an open-source ecosystem for creating, sharing, and publishing resumes using a standardized JSON format. This monorepo integrates the marketing site, a hosted registry, documentation, schema, CLI, and themes. It empowers users to generate portable, machine-readable resumes, publish them online with unique URLs, render them with diverse themes, validate against a formal schema, and leverage AI tools for job searching.

How It Works

The project is structured as a Turborepo monorepo managed by pnpm. It centralizes development for key components including the Next.js-powered hosted registry (which renders themes and offers AI features), the marketing site, Fumadocs-based documentation, the core @jsonresume/schema and validator, a resume-cli, and Rust-based serde bindings (json-resume-serde). This unified architecture facilitates consistent development and deployment across the entire JSON Resume platform.

Quick Start & Requirements

• Installation: Requires pnpm. Install via curl -fsSL https://get.pnpm.io/install.sh | sh.
• Project Setup: Clone the repository, cd into it, and run pnpm install.
• Running the Registry: Navigate to apps/registry and execute pnpm dev.
• Usage: Access rendered resumes at http://localhost:3000/<username> or append ?theme=<slug> to test themes.
• Monorepo Commands: Use pnpm turbo <task> (e.g., pnpm turbo dev, pnpm turbo build) for workspace-wide operations, or pnpm turbo <task> --filter=<app/package> for specific components.
• Links: Documentation: docs.jsonresume.org, Hosted registry: registry.jsonresume.org, Marketing site: jsonresume.org.

Highlighted Details

• Integrates AI-powered tools within the registry for job recommendations, cover letter generation, resume suggestions, and interview simulations.
• Features approximately 46 official community-built themes, with a defined workflow for developing custom themes.
• The project consolidated from prior standalone repositories into this monorepo in 2026, preserving established npm package names.
• Includes an ATS (Applicant Tracking System) validator for checking the compatibility of resume HTML.

Maintenance & Community

• NPM packages are released using Changesets, with a release-packages.yml workflow automating versioning and publishing.
• A Discord community is available for discussions, support, and collaboration.

Licensing & Compatibility

• Licensed under the MIT License.
• This permissive license allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The README does not explicitly detail project limitations, alpha status, or known bugs. AI features require the configuration of external provider API keys.