Kubb 5.x · API spec to code 8.7M yearly downloads

Turn your API spec into type-safe code.

Kubb is an open source code generator. Point it at your API spec, such as OpenAPI, and get TypeScript types, fetch or axios clients, TanStack Query and SWR hooks, Zod schemas and MSW mocks, always in sync with your API.

Get started

Open source, MIT licensed
OpenAPI 2.0, 3.0 and 3.1
Runs anywhere Node runs

openapi.yaml42 paths · 18 schemas

src/gen/hooks/useGetPet.ts

export function getPetQueryOptions(
  { path }: GetPetOptions,
) {
  return queryOptions({
    queryKey: getPetQueryKey({ path }),
    queryFn: ({ signal }) =>
      getPet({ path, signal }).unwrap(),
  })
}

export function getPet(
  options: Options<GetPetOptions>,
) {
  return withUnwrap(client({
    method: 'GET',
    url: '/pet/{petId}',
    ...options,
  }))
}

export type Pet = {
  id: number
  name: string
  status?: PetStatusEnumKey
}

Generates code for

How it works

From spec to code in three steps

Every Kubb run follows the same pipeline, so adding a plugin never changes how the others behave.

01 · Adapt

An adapter parses your spec into one shared AST, so every plugin reads the same model.

02 · Generate

Plugins turn that AST into types, clients, hooks, validators and mocks. Pick the ones your stack needs.

03 · Print

Parsers write the result as TypeScript or Markdown files, with barrel files and formatting handled.

See it in action

One API spec, typed code for every layer

Switch tabs to see the TypeScript types, React Query hooks and Zod schemas Kubb generates from one API spec.

petstore.yaml

openapi: 3.0.0
info:
  title: Pet Store API
  version: 1.0.0
paths:
  /pets:
    get:
      operationId: getPets
      summary: List all pets
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: A list of pets
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Pet'
components:
  schemas:
    Pet:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: integer
        name:
          type: string
        status:
          type: string
          enum: [available, pending, sold]

Ecosystem

Adapters, plugins and parsers

Mix and match what your stack needs: types, clients, hooks, validators and mocks.

Plugins

14 official plugins for TypeScript, Zod, TanStack Query, MSW and more.

Adapters

1 adapter that reads OpenAPI 2.0, 3.0 and 3.1 into the Kubb AST.

Parsers

2 parsers that print generated code as TypeScript or Markdown.

Downloads

Downloaded from npm every day

Download counts for @kubb/core, taken from the npm registry.

Kubb

@kubb/core

npm

8.7M

Total downloads (year)

385.0K+

Weekly

By the numbers

Built in the open

GitHub stars

Contributors

Official plugins

Yearly downloads

Review every generated change in Kubb Studio.

Connect the Kubb CLI or a Docker agent, generate from the browser and diff the output before it reaches your repository. Code stays on machines you control unless you allow Studio to read it.

Open Kubb Studio Read the Studio guide