Roadmap Kubb v5

[stijnvanhulle]

Kubb v5 Roadmap

This document outlines the planned features and improvements for Kubb version 5. This roadmap is subject to change based on community feedback and priorities.

🚀 New Features

@kubb/plugin-client

• Support class-based client generation in @kubb/plugin-client #1967
• Support for Zod mini #1848
• Support for suspense infinite hook in react query #1516
• operationTypes to simplify generated operation types plugins#16
• Transformers to transform strings to dates in client (like Zod does)
  • Related: Suggestion to auto convert date value from type string to type Date #1429
  • Note: Requires parser refactor first to make it easier to use

@kubb/plugin-faker

• Add support for localized Faker instances so other languages next to English could be used

Developer Tools

• Logger plugin for Github/ClI/plain
• Improved debugging logs

🎯 Core & Architecture

Upgrades

• Minimal of Node 22 support

New AST/schema layout

• Use AST inside of plugin-ts

defineStorage

• Make it poissible to use external storages like s3

@kubb/cli

• Add a config repo to share github actions, ...
• Create changelog.md in docs automaticly with Cursor/ai
• Add Github Action action-dependency-diff of e18e #2214
• Add agents.md documentation
• Run format and linting before commting changes in Github Copilot
• Remove pluginKey, only pluginName possible. No duplicated plugins without a new config #2769

@kubb/fabric-core

https://github.com/kubb-labs/fabric

• Include React in the Fabric bundle to resolve npm issues
• Update event names in Fabric to be more aligned with Kubb
• replace createParser and createPlugin with defineParser and definePlugin
• Make fetch exportable and replace barrel logic in Kubb with Fabric's logic (barrelPlugin)
• Add resolveName and resolvePath as part of Fabric (cannot be async because of React renderer)
• Check benchmark repository for performance comparisons between other generators
• Check benchmark with pnpm perf to improve creation
• barrelPlugin should not have a root and find it's own root.
• Support for FSX (@kubb/fabric-core)

Parser Refactoring

• Refactor Faker/TypeScript/Zod parsers to combine tree and schema with better naming

Code Quality

• Use Knip for unused code detection #2213
• Add 'auto' option for format #2211
• Add 'auto' option for lint #2212
• Add feat: enum type naming #2916 to v5

Removal of Kubb defaults

• set integerType to 'bigint' as default

📝 Notes

• This roadmap is a living document and will be updated as priorities shift
• Community feedback and contributions are welcome
• Items are not necessarily in priority order
• Some items may be moved to future versions based on complexity and dependencies

🤝 Contributing

If you're interested in working on any of these items, please:

1. Check existing issues and discussions
2. Open a new issue to discuss your approach
3. Submit a pull request when ready

[stepek]

Plan to work on patternProperties - need it for project.

[stijnvanhulle]

@stepek What do you exactly mean with patternProperties?

[rzschoch]

The generated faker factories currently use the default English locale. For projects targeting other regions (like Germany in our case), a locale option that imports localized Faker instances (e.g., fakerDE instead of faker) would make mock data much more realistic.

Did I maybe miss something in the docs, or is this already on the roadmap? Thanks! 🙏