Documentation · Report Bug · Request Feature

Point Kubb at a schema and it generates types, clients, hooks, validators, mocks, and more.

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

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.

• 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.

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

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.

Stijn Van Hulle 💻	Alfred 💻	Kirill Agalakov 💻	Nick Williams 📖	helt 💻	Vasily Mikhaylovsky 💻	Chaim Lev-Ari 💻
Pavel Belousov 💻	Dmitry Belov 💻	Alex Burgel 💻	Daniel Garcia 💻	wuyuanyi135 💻	Chris Thompson 💻	Caleb Hoyoul Kang 💻
Gregory Zhukovsky 💻	Christoffer Nørbjerg 💻	CHE1RON 💻	ekaradon 💻	Thijmen Stavenuiter 💻	Bohdan Husak 📖	Éric Le Maître 💻
Rubens Pereira do Nascimento 💻	Matt Sutkowski 💻	Vítor Camacho 💻	Václav Procházka 💻	Luiz Bett 💻	Sebastian Andersen 💻	Akino 💻
Ricardo Machado 💻	Simon El Nahas 📖	maartenvansambeek 💻	Stefan du Fresne 💻	Hugo Felippe de Souza Cruz 💻	Sébastien Vanvelthem 💻	Vitaly Gashkov 📖
Duco Drupsteen 💻	th3l0g4n 💻	rxliuli 💻	humarkx 💻	Jakub Cerovsky 💻	Pachara Chantawong 💻	Volodymyr Kushnir 💻
GKNewsrooms 💻	Kamil Stepczuk 💻	João Brilhante 💻	Kamil Sieradzki 💻	Eric Pierlot 💻	Alexander Sjöcrona Tholin 💻	Stephen Zhou 💻
Ilia Choly 💻	Alex Skoropad 💻	Jay Patel 💻	Hamza Mihai Daniel 💻	DesselBane 💻

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

See LICENSE for details.