@kubb/core

Kubb

The meta framework for code generation

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

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.

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 output with custom plugins, adapters, and the JSX renderer (@kubb/renderer-jsx).
• 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

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

License

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

See LICENSE for details.

Star history