Kubb

Turn your API spec into type-safe code

Kubb turns an API spec, such as OpenAPI, into TypeScript types, API clients, hooks, validators and mocks, and keeps them in sync with your API. It reads OpenAPI 2.0, 3.0 and 3.1.

Installation

bun add kubb
# or
pnpm add kubb
# or
npm install kubb

Quick start

Run the setup wizard to create a kubb.config.ts:

npx kubb init

The wizard creates a package.json if needed, guides you through plugin selection, installs packages, and writes kubb.config.ts. Then generate your code:

npx kubb generate

See the documentation for detailed usage and advanced features.

Kubb Studio

Kubb Studio is the visual companion for Kubb. Configure, run, and inspect generations in the browser while Kubb runs in your project or on an agent you control.

Try Studio's shared sandbox, connect a local project, or publish reviewable snapshots from CI. Kubb remains MIT-licensed and works without Studio.

Features

• Generate TypeScript types, type-safe clients, TanStack Query and SWR hooks, Zod validators, Faker mocks, and MSW handlers from one schema.
• Generate a typed axios or Fetch client with status-keyed results, auth, validation, file uploads, server-sent events, interceptors, and a swappable transport.
• Read OpenAPI 2.0, 3.0, and 3.1 through adapters like @kubb/adapter-oas, with output for Node.js and Bun.
• Enable only the plugins you need: plugin-ts, plugin-axios, plugin-fetch, plugin-react-query, plugin-vue-query, plugin-swr, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-redoc, plugin-mcp.
• Shape the output by grouping files by tag, including or excluding operations, and writing to disk, memory, or a custom storage backend.
• Build your own plugins, generators, adapters, and renderers with the kubb/kit authoring toolkit, plus a JSX renderer for component-based output.
• Run generation in your bundler with unplugin-kubb for Vite, Nuxt, Astro, webpack, and more.
• Drive generation from AI tools over the built-in MCP server (Claude, Cursor) or inside Claude Code.

Supporting Kubb

Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:

• Become a Sponsor on GitHub
• Back Kubb on Open Collective
• See sponsorship tiers and our sponsors

Contributing

We welcome contributions that help improve Kubb. A few ways to get involved:

• Found a bug? File it in the issue tracker.
• Have an idea to improve Kubb? Open an issue to share it.
• Need help? Ask the community on Discord.

See CONTRIBUTING.md for the project structure, local setup, and commands.

Contributors

License

This repository is licensed under the MIT License, Copyright © 2025 Stijn Van Hulle.

See LICENSE for details.

Star history