# kubb-labs/kubb

🧡 The meta framework for code generation. Automate OpenAPI to type-safe TypeScript, Zod, and TanStack Query with a modular, plugin-based engine.

Repository: https://github.com/kubb-labs/kubb
Canonical: https://ross.abutalabs.com/products/kubb
Homepage: https://kubb.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: plugin-manager, swagger, typescript, axios, codegen, kubb, openapi, react, react-query, zod, solid, svelte, vue, swr, zodios, faker, msw, claude, mcp
Last push: 2026-08-26T18:52:00+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 95
- inputs: {"age_days": 1333, "days_push": 7, "days_rel": 9, "gap_med": 0, "n_releases_24m": 248}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1789, forks 146 (observed 2026-08-28T04:05:36.923829+00:00)

## What it is
Kubb is a meta framework for code generation that turns OpenAPI/Swagger specifications into type-safe TypeScript code via a plugin-based pipeline. It generates types, API clients (Axios/Fetch), React Query/Vue Query/SWR hooks, Zod validators, MSW mocks, and Faker mocks from a single config.

## Use cases
- generate TypeScript types from OpenAPI spec
- generate React Query hooks from Swagger
- generate Zod schemas from OpenAPI
- generate MSW mocks and Faker data from API spec
- generate typed Axios or Fetch client from OpenAPI
- generate MCP server from OpenAPI spec
- validate OpenAPI specification

## When to choose
- you maintain an OpenAPI/Swagger spec and want type-safe generated clients, hooks, and validators
- you want deterministic, plugin-based codegen with custom output support
- you use React Query, Vue Query, SWR, Zod, or MSW in a TypeScript stack

## When to avoid
- your API is not described by OpenAPI/Swagger and you don't want to write a custom adapter
- you need code generation for non-TypeScript target languages out of the box
- you prefer hand-written clients with full manual control

## Facets
- artifact type: framework
- maturity: active
- function: api-framework, type-system, plugin-system, cli
- domain: developer-tools, apis, web-development
- platform: cli
- tags: openapi, codegen, zod, react-query, swagger, msw, mocks, mcp, code generation, nodejs, typescript

## Member repositories
- kubb-labs/kubb (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:36.923829+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:23:18.799558+00:00, confidence not recorded.
  - readme: https://github.com/kubb-labs/kubb (fetched 2026-08-28T04:05:36.923829+00:00, sha 6e0e55439b1a)
  - homepage: https://kubb.dev (fetched 2026-08-29T11:02:41.052454+00:00, sha 573062192e01)
  - site_page: https://kubb.dev/docs/5.x/getting-started/introduction (fetched 2026-08-29T11:02:41.055390+00:00, sha 489cb8652e8d)
  - site_page: https://kubb.dev/about (fetched 2026-08-29T11:02:41.057486+00:00, sha f672a438a1af)
  - site_page: https://kubb.dev/docs/5.x/migration (fetched 2026-08-29T11:02:41.059364+00:00, sha b3d720cf3062)
  - site_page: https://kubb.dev/docs/5.x/changelog (fetched 2026-08-29T11:02:41.062067+00:00, sha 20e681f4c912)
  - site_page: https://kubb.dev/docs/5.x/guide/concepts/architecture (fetched 2026-08-29T11:02:41.063925+00:00, sha c33f9abdc018)
  - site_page: https://kubb.dev/docs/5.x/reference/kit (fetched 2026-08-29T11:02:41.065675+00:00, sha 089b9d7d3451)
  - site_page: https://kubb.dev/docs/5.x/community/contributing (fetched 2026-08-29T11:02:41.067335+00:00, sha f0b31f5cc8e7)
  - site_page: https://kubb.dev/docs/5.x/ai/claude (fetched 2026-08-29T11:02:41.069437+00:00, sha e07685998e4c)
- Data as of 2026-08-30T08:39:29.467469+00:00.