npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@jsume/schemas

v0.0.7

Published

Schemas for JSUME

Readme

@jsume/schemas

npm version npm downloads

Zod schema and JSON schema for Jsume.

If you want to use Zod schema, you can import them like this:

import { jsumeSchema } from '@jsume/schemas'

Import individual schemas:

import {
  awardsSchema,
  basicsSchema,
  certificatesSchema,
  educationSchema,
  languagesSchema,
  projectsSchema,
  publicationsSchema,
  skillsSchema,
  workSchema
} from '@jsume/schemas'

You can also import JSON schema:

import jsonSchema7 from '@jsume/schemas/draft-7.json'
import jsonSchema2020 from '@jsume/schemas/draft-2020-12.json'

Schema Details

jsume.json
├── basics
│   ├── name
│   ├── label
│   ├── image
│   ├── email
│   ├── phone
│   ├── url
│   ├── summary
│   ├── location
│   └── profiles
├── work
│   ├── company
│   ├── positon
│   ├── website
│   ├── location
│   ├── startDate
│   ├── endDate
│   ├── summary
│   └── highlights
├── projects
│   ├── name
│   ├── summary
│   ├── description
│   ├── githubUrl
│   ├── website
│   └── keywords
├── publications
│   ├── name
│   ├── releaseDate
│   ├── publisher
│   ├── summary
│   └── url
├── education
│   ├── institution
│   ├── description
│   ├── major
│   ├── degree
│   ├── location
│   ├── startDate
│   ├── endDate
│   ├── activities
│   ├── gpa
│   └── courses
├── certificates
│   ├── name
│   ├── issueDate
│   ├── expDate
│   ├── issuer
│   └── url
├── awards
│   ├── title
│   ├── summary
│   ├── description
│   ├── awarder
│   └── date
├── skills
│   ├── name
│   └── keywords
└── languages
    ├── language
    └── fluency

Jsume Schema

There are some special data types in the schema that you should be aware of at the beginning:

  1. basics
  2. work
  3. projects
  4. publications
  5. education
  6. certificates
  7. awards
  8. skills
  9. languages
  1. basics

    Basic information about yourself.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | name | string | ✅ | Your name | "John Doe" | | label | string | ❌ | Your professional label or title | "Software Engineer" | | image | url | ❌ | URL to your profile image | "https://example.com/profile.jpg" | | email | email | ❌ | Your email address | "[email protected]" | | phone | string | ❌ | Your phone number | "(912) 555-4321" | | url | url | ❌ | URL to your website or portfolio | "https://johndoe.com" | | summary | string | ❌ | Write a short 2-3 sentence biography about yourself | "I am John Doe, a software engineer with 5 years of experience in web development..." | | location | location | ❌ | Your current location | "United States" , {"city": "New York", "country": "United States"} | | profiles | object | ❌ | Specify any number of social networks that you participate in | {"network": "X/Twitter", "username": "john", "url": "https://x.com/john"} |

    {
      "name": "John Doe",
      "label": "Software Engineer",
      "image": "https://example.com/profile.jpg",
      "email": "[email protected]",
      "phone": "(912) 555-4321",
      "url": "https://johndoe.com",
      "summary": "I am John Doe, a software engineer with 5 years of experience in web development...",
      "location": {
        "city": "New York",
        "country": "United States"
      },
      "profiles": [
        {
          "network": "X/Twitter",
          "username": "john",
          "url": "https://x.com/john"
        }
      ]
    }
  2. work

    List of your working experiences.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | company | string | ✅ | Company name | "Then Company" | | location | location | ❌ | Where you worked or where the company is located | "Remote" , {"city": "New York", "country": "United States"} | | position | string | ✅ | Your position at the company | "Software Engineer" | | website | url | ❌| URL to the company website | "https://company.com" | | startDate | date | ✅ | Start date of your employment at the company | {"year": 2023, "month": 1} , {"year": 2023, "month": 1, "day": 1} | | endDate | fales or date | ✅| End date of your employment at the company. If you are still working there, set this to false | false , {"year": 2023, "month": 1} | | summary | string | ❌ | Give an overview of your responsibilities at the company | "Here is the summary of my work..." | | highlights | array | ❌ | List of highlights or achievements during your time at the company | ["Highlight 1", "Highlight 2"] |

    [{
      "company": "The Company",
      "location": "Remote",
      "position": "Software Engineer",
      "website": "https://company.com",
      "startDate": {
        "year": 2023,
        "month": 1
      },
      "endDate": false,
      "summary": "Here is the summary of my work...",
      "highlights": [
        "Highlight 1",
        "Highlight 2"
      ]
    }]
  3. projects

    List your projects and personal work experience, including open source contributions and side projects.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | name | string | ✅ | Project name | "My First Project" | | website | url | ❌ | Url to the project website | "https://projects.johndoe.com/my-first-project" | | githubUrl | githubUrl | ❌ | URL to the project repository on GitHub | "https://github.com/johndoe/my-first-project-repo" | | startDate | date | ✅* | Start date of the project | {"year": 2023, "month": 1} | | endDate | fales or date | ✅*| End date of the project, or false if the project is ongoing | false , {"year": 2023, "month": 1} | | summary | string | ❌ | Give an overview of your project | "Here is the summary of my project..." | | highlights | array | ❌ | Specify multiple accomplishments | ["Highlight 1", "Highlight 2"] |

    startDate and endDate are dependent required fields.

    [{
      "name": "Project",
      "website": "https://project.com",
      "githubUrl": "https://github.com/johndoe/reponame",
      "startDate": {
        "year": 2023,
        "month": 1
      },
      "endDate": false,
      "summary": "Here is the summary of my project...",
      "highlights": [
        "Highlight 1",
        "Highlight 2"
      ]
    }]
  4. publications

    Specify your publications through your career.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | name | string | ✅ | Name of the publication | "The World Wide Web" | | releaseDate | date | ✅ | Date when the publication released | {"year": 2023, "month": 1} | | publisher | string | ❌ | Name of the publisher or organization that released the publications | "IEEE, Computer Magazine" | | summary | string | ❌ | Short summary of publication | "Discussion of the World Wide Web, HTTP, HTML." | | url | url | ❌| URL to the publication | "https://www.computer.org.example.com/csdl/mags/co/1996/10/rx069-abs.html" |

    startDate and endDate are dependent required fields.

    [{
      "name": "The World Wide Web",
      "releaseDate": {
        "year": 2023,
        "month": 1
      },
      "publisher": "IEEE, Computer Magazine",
      "summary": "Discussion of the World Wide Web, HTTP, HTML.",
      "url": "https://www.computer.org.example.com/csdl/mags/co/1996/10/rx069-abs.html"
    }]
  5. education

    List of your educations.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | institution | string | ✅ | Institution name | "University of Example" | | location | location | ❌ | Where the institution is located or where you studied | "United States" , {"city": "New York", "country": "United States"} | | major | string | ✅ | Field of study or major | "Computer Science" | | degree | string | ✅ | Degree obtained or pursued | "Bachelor of Science" | | gpa | number | ❌ | Grade Point Average (GPA) | 3.8 | | startDate | date | ✅ | Start date of the education period | {"year": 2023, "month": 1} | | endDate | fales or date | ✅ | End date of the education period, or false if currently studying there | false , {"year": 2023, "month": 1} | | activities | array | ❌ | Specify multiple activities you participated in during your education | ["Activity 1", "Activity 2"] | | courses | array | ❌ | Specify multiple relevant courses you took during your education | ["Course 1", "Course 2"] |

    [{
      "institution": "University of Example",
      "location": "Online",
      "major": "Computer Science",
      "degree": "Bachelor of Science",
      "gpa": 3.8,
      "startDate": {
        "year": 2023,
        "month": 1
      },
      "endDate": {
        "year": 2023,
        "month": 1
      },
      "activities": [
        "Activity 1",
        "Activity 2"
      ],
      "courses": [
        "Course 1",
        "Course 2"
      ]
    }]
  6. certificates

    Specify any certificates you have received throughout your professional career.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | name | string | ✅ | Name of the certificate | "Certified Kubernetes Administrator" | | issueDate | date | ✅ | Date when the certificate was received | {"year": 2023, "month": 1} | | expDate | fales or date | ✅ | Expiration date of the certificate, or false if it does not expire | false , {"year": 2023, "month": 1} | | issuer | string | ✅ | Organization or individual who granted the certificate | "CNCF" | | url | url | ❌ | URL to the certificate or credential | "https://www.youracclaim.com/badges/xxxx" |

    [{
      "name": "Certified Kubernetes Administrator",
      "issueDate": {
        "year": 2023,
        "month": 1
      },
      "expDate": false,
      "issuer": "CNCF",
      "url": "https://www.youracclaim.com/badges/xxxx"
    }]
  7. awards

    List of your awards or honors.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | title | string | ✅ | The title of the award or honor | "Employee of the month" | | date | date | ✅ | Date when the award or honor was received | {"year": 2023, "month": 1, "day": 1} | | awarder | string | ✅ | Organization or individual who granted the award or honor | "Tech Company Inc." | | summary | string | ❌ | Summary of the award or honor | "Awarded for outstanding performance and dedication to the team." | | description | string | ❌ | Detailed description of the award or honor | "I play a key role in the team and help the team achieve its goals..." |

    [{
      "title": "Employee of the month",
      "date": {
        "year": 2023,
        "month": 1,
        "day": 1
      },
      "awarder": "Tech Company Inc.",
      "summary": "Awarded for outstanding performance and dedication to the team.",
      "description": "I play a key role in the team and help the team achieve its goals..."
    }]
  8. skills

    List of your skills.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | name | string | ✅ | Name of the skill | "Frontend" | | keywords | array | ✅ | List of keywords related to the skill | ["JavaScript", "React", "Vue"] |

    [{
      "name": "Frontend",
      "keywords": [
        "JavaScript",
        "React",
        "Vue"
      ]
    }]
  9. languages

    List the languages you speak.

    | property | type | required | desc | e.g. | |:---:|:---:|:---:|---|---| | language | string | ✅ | Language name | "English" | | fluency | string* | ✅ | Fluency level | "Fluent" |

    [
      {
        "language": "English",
        "fluency": "Fluent"
      },
      {
        "language": "Chinese",
        "fluency": "Native"
      }
    ]