@kubb/core

The meta framework for code generation

Stop writing glue code. Define your API once and Kubb generates types, clients, hooks, validators, mocks and more.

Documentation · Report Bug · Request Feature

Installation

npm install @kubb/core
# or
pnpm add @kubb/core

Quick Start

Get started with Kubb in seconds:

npx kubb init

The interactive setup will:

• Create a package.json (if needed)
• Guide you through plugin selection
• Install packages automatically
• Generate kubb.config.ts

Then generate your code:

npx kubb generate

See the documentation for detailed usage and advanced features.

Features

• Works with Node.js 22+ and TypeScript 6.
• Convert Swagger 2.0, OpenAPI 3.0, and OpenAPI 3.1 to TypeScript types, API clients, and more via the plugin ecosystem.
• Extensible plugin and middleware system for customizing and composing code generation.
• CLI support with interactive setup, progress bar, and detailed logs.
• Model Context Protocol (MCP) server for AI assistants like Claude, Cursor, and other MCP-compatible tools.
• JSX-based renderer (@kubb/renderer-jsx) for building custom plugin output.
• Barrel file generation via the @kubb/middleware-barrel middleware.

Supporting Kubb

Kubb is an open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:

• Become a Sponsor on GitHub

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 💻	Sascha Buehrle 💻

License

Most of this repository is licensed under the MIT License, Copyright © 2025 Stijn Van Hulle. Some components are licensed under AGPL-3.0-or-later.

• Most packages — MIT
• @kubb/agent — AGPL-3.0-or-later

See LICENSE for details.

Star History