asteasolutions/zod-to-openapi

Health v2 · maintenance only

Adoption not part of the score

1629 stars · 105 forks observed · 2026-10-08

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

A TypeScript library that generates OpenAPI (Swagger) documentation directly from Zod schemas, eliminating duplication between validation code and API docs. It provides a registry and generator for defining routes, webhooks, and reusable schema components from a single source of truth.

Use cases

• generate openapi spec from zod schemas
• keep swagger docs in sync with api validation
• document express or hono api endpoints automatically
• convert zod types to openapi 3.0 schema
• generate swagger yaml as part of the build
• define api routes and webhooks with zod
• avoid duplicating schema definitions for docs and validation

When to choose

• you already use zod for validation and want docs from the same schemas
• you want a single source of truth for API schemas and documentation
• you need OpenAPI 3.0/3.1 output generated at build time or runtime

When to avoid

• your API is not written in TypeScript or does not use zod
• you need docs generated from code annotations or framework decorators instead
• you rely on zod v3 and need actively maintained support

Facets

library · maturity active

api-documentation serialization developer-tools apis web-development backend developer-tools documentation cross-platform zod openapi swagger schema-generation api-docs typescript nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="asteasolutions/zod-to-openapi")