jsonresume-theme-onepage-simplified

A simplified, compact, and printable theme for JSON Resume that fits an entire resume on a single page.

About This Fork: This is a maintained fork and continuation of jsonresume-theme-onepage by Ainsley Chong, combining improvements from the jsonresume-theme-onepage-ds variant. It offers modernized tooling, enhanced styling, and better maintainability while preserving the clean, single-page design philosophy.

Table of Contents

• Features
• About This Fork
• Installation
• Usage
• JSON Resume Format
• Theme Features
• Customization
• Development
• Releasing
• Browser Support
• Contributing
• License
• Authors
• Credits

Features

• 📄 Single Page Design - Optimized to fit a complete resume on one page
• 🎨 Clean & Minimal - Professional, distraction-free layout
• 🖨️ Print-Friendly - Perfect for PDF export and printing
• 📱 Responsive - Works on all screen sizes
• ⚡ Lightweight - Minimal dependencies
• 🎯 Smart Formatting - Automatically organizes courses into columns (3-column layout)

About This Fork

This project builds upon the excellent foundation laid by Ainsley Chong's original jsonresume-theme-onepage theme. Key improvements in this version include:

• Modern Tooling: Updated to use Vite for faster builds and better development experience
• Enhanced Styling: Refined CSS for improved visual hierarchy and readability
• Better Maintainability: Cleaner codebase with improved build configuration
• Active Maintenance: Regular updates and community contributions
• Backward Compatibility: Maintains compatibility with the original theme format

For detailed fork history, see the Credits section.

Installation

Using pnpm (recommended)

pnpm add jsonresume-theme-onepage-simplified

Using npm

npm install jsonresume-theme-onepage-simplified

Using yarn

yarn add jsonresume-theme-onepage-simplified

Usage

With resumed CLI (Recommended)

npx resumed render resume.json --theme jsonresume-theme-onepage-simplified --output resume.html

From Source

git clone https://github.com/akarsh/jsonresume-theme-onepage-simplified.git
cd jsonresume-theme-onepage-simplified
pnpm install
pnpm build
pnpm render

Programmatically

import theme from 'jsonresume-theme-onepage-simplified';
import resume from './resume.json';

const html = theme.render(resume);

JSON Resume Format

Your resume should follow the JSON Resume Schema. Here's a basic structure:

{
  "basics": {
    "name": "Your Name",
    "label": "Professional Title",
    "email": "[email protected]",
    "phone": "+1 (555) 123-4567",
    "url": "https://yourwebsite.com",
    "summary": "A brief professional summary",
    "location": {
      "address": "123 Main St",
      "postalCode": "12345",
      "city": "City",
      "countryCode": "US",
      "region": "State"
    },
    "profiles": [
      {
        "network": "LinkedIn",
        "username": "yourprofile",
        "url": "https://linkedin.com/in/yourprofile"
      }
    ]
  },
  "work": [...],
  "education": [...],
  "skills": [...]
}

Theme Features

Smart Course Organization

Courses listed in education are automatically split into 3 columns for compact display.

Section Transformation

The theme intelligently transforms resume sections:

• Summaries in work, volunteer, awards, and publications sections are converted to highlights
• Skills are displayed with proficiency levels
• Education includes institutions and study types

Customization

Available Options

For the "experience" and "skills" sections, you can optionally replace the "highlights" list with a "details" list:

"details": [
  { "text": "Javascript", "comment": "expert" },
  { "text": "Coffeescript", "comment": "expert" },
  { "text": "Ruby", "comment": "competent" },
  { "text": "Java", "comment": "novice" }
]

Styling

The theme uses clean, minimal CSS in style.css. You can:

• Fork this repository and modify style.css to customize appearance
• Override styles in your own stylesheet
• Modify the Handlebars template in resume.hbs

Website URLs

⚠️ Note: Website parameters in work experience, publishing, and volunteering are commented out in resume.hbs to save space in the print version.

Development

Prerequisites

• Node.js 20+
• pnpm 10.33.0+

Setup

git clone https://github.com/akarsh/jsonresume-theme-onepage-simplified.git
cd jsonresume-theme-onepage-simplified
pnpm install

Build

pnpm build  # builds dist/index.js via Vite

Testing

To test rendering locally after making changes:

pnpm build && pnpm render

This generates resume.html from resume.json using your modified theme.

Releasing

This project uses Release Please for automated version management and releases.

How Releases Work

Release Please automatically manages versioning and changelog generation based on conventional commits.

Workflow:

1. Make commits with conventional commit messages (see examples below)
2. Push to main branch
3. Release Please creates a Release PR with:
   • Updated CHANGELOG.md
   • Bumped version in package.json
   • Semantic version based on commit types
4. Review and merge the Release PR
5. On merge, a GitHub Release is created automatically
6. Publishing to npm is triggered by the GitHub Release

Conventional Commit Format

Use these commit message prefixes to trigger version bumps:

feat: Add new feature           (bumps MINOR version)
fix: Bug fix                    (bumps PATCH version)
perf: Performance improvement   (bumps PATCH version, "Performance" section in changelog)
refactor: Code refactoring      (bumps PATCH version, in changelog)
docs: Documentation update      (no version bump, but in changelog)
BREAKING CHANGE: ...            (bumps MAJOR version)

Examples:

# Feature (minor version bump)
git commit -m "feat: add 3-column course layout"

# Bug fix (patch version bump)
git commit -m "fix: correct spacing in education section"

# Breaking change (major version bump)
git commit -m "feat!: redesign resume layout
BREAKING CHANGE: old resume.json format no longer supported"

Automatic npm Publishing

The publish workflow (publish.yml) automatically publishes to npm when a GitHub Release is created (which happens automatically after merging the Release PR).

See CHANGELOG.md for version history and .release-please.json for configuration.

Browser Support

• Chrome (latest)
• Firefox (latest)
• Safari (latest)
• Edge (latest)

Resources

• JSON Resume - Official website
• JSON Resume Schema - Complete schema documentation
• resumed CLI - CLI tool for rendering resumes

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/improvement)
3. Make your changes
4. Test with pnpm build && pnpm render
5. Submit a pull request

License

MIT - See LICENSE.md for details

Authors

Current Maintainers (This Fork):

• Divyendu Singh
• Akarsh Seggemu

Original Creator:

• Ainsley Chong — See Fork History for details

Credits

Fork History

This project is a continuation and modernization of:

1. jsonresume-theme-onepage (Original)

   • Creator: Ainsley Chong
   • The foundational single-page resume theme
   • License: MIT

2. jsonresume-theme-onepage-ds (Enhancement Fork)

   • Creator: Divyendu Singh
   • Added improvements and maintained the theme
   • License: MIT

3. jsonresume-theme-onepage-simplified (Current, This Repository)

   • Current Maintainers: Divyendu Singh, Akarsh Seggemu
   • Modern tooling, enhanced styling, active maintenance
   • License: MIT

Open Source Dependencies

We also acknowledge these projects:

• jsonresume-theme-boilerplate by 8+ contributors — MIT License