Documentation · Report Bug · Request Feature

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 from a schema: Kubb produces TypeScript types, type-safe API clients, TanStack Query hooks for React and Vue, SWR hooks, Zod validators, Faker mocks, and MSW handlers.
• Plug in input formats through adapters like @kubb/adapter-oas, with TypeScript-first output that runs on Node.js and Bun.
• Pick what you generate from the plugin ecosystem: plugin-ts, plugin-axios, plugin-fetch, plugin-react-query, plugin-vue-query, plugin-swr, plugin-zod, plugin-faker, plugin-msw, plugin-cypress, plugin-redoc, and plugin-mcp. Enable only the ones a project needs.
• Choose your HTTP client: use the axios or fetch presets, or point at a custom client module so generated requests run through your own wrapper.
• Control the generated tree: group files by tag, emit barrel exports, and include or exclude operations to keep the output focused.
• Build your own output with custom plugins, adapters, and the JSX-based renderer (@kubb/renderer-jsx) for full control over what lands on disk.
• Hook into your bundler with unplugin-kubb, which runs generation inside Vite, Nuxt, Astro, webpack, and other build tools.
• Drive generation from AI tools through the built-in Model Context Protocol (MCP) server, which works with Claude, Cursor, and other MCP-compatible assistants.
• Generate from inside Claude Code with the Kubb plugin, which adds slash commands, a config skill, and an agent that run the Kubb CLI.

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