APIDevTools/json-schema-ref-parser

Health v2 · maintenance only

Adoption not part of the score

1113 stars · 251 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A JavaScript/TypeScript library that parses, resolves, and dereferences JSON Schema $ref pointers, supporting external files, URLs, JSON/YAML, circular references, and custom resolvers. It can bundle multi-file schemas into a single self-contained schema or produce plain JavaScript object trees.

Use cases

• resolve $ref pointers in a JSON Schema across local files and URLs
• bundle a multi-file OpenAPI spec into a single file
• dereference a JSON Schema into a plain JavaScript object
• load schemas written in a mix of JSON and YAML
• handle circular references in JSON Schemas
• add a custom resolver to load $refs from a database
• validate or preprocess OpenAPI definitions before code generation

When to choose

• you work with JSON Schema or OpenAPI specs that use $ref pointers to external files or URLs
• you need to bundle or flatten multi-file schemas into one portable document
• your schemas mix JSON and YAML or contain circular references
• you need the same library to run in both Node.js and browsers

When to avoid

• you need full JSON Schema validation rather than reference resolution
• you work with non-JSON/YAML schema formats or non-JSON Reference linking conventions
• you need a language other than JavaScript/TypeScript

Facets

library · maturity stable

parser developer-tools yaml developer-tools apis web-development parsers browser cross-platform -schema -pointer -reference openapi dereference bundle schema-resolution typescript nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="APIDevTools/json-schema-ref-parser")