Description
I'm posting this issue to all the libraries currently listed in the Ecosystem section of Zod's README. Apologies for the spam! Zod 4 is a big release and it's important to get as much of the ecosystem migrated as possible! 👍
Zod 4 is now in beta
Hello! Colin here, creator of Zod. Thank you for contributing this package to the Zod ecosystem!
FYI, the first beta of Zod 4 has been released. It will be in beta for 4 weeks to allow time for ecosystem libraries (such as yours) to implement support before the first stable version is released. The first stable release will be in mid-May. Keep an eye on this PR to track progress: colinhacks/zod#4074
Announcement post: https://v4.zod.dev/v4
Migration guide: https://v4.zod.dev/v4/changelog
Migration
There have been some significant changes.
- A new library
@zod/mini
has been released with a treeshakable/functional API that mirrors Zod's - To facilitate code sharing between
zod
and@zod/mini
, they both have a dependency on a new common core library@zod/core
. - This new package implements the schema subclasses that are then extended by
zod
and@zod/mini
(and potentially future libraries). It makes it easy to support all these libraries simultaneously, with just one peerDependency on your end. There is little reason for any framework/library to depend directly onzod
anymore.
pnpm install @zod/core@^0.0.1
This page is intended as a jumping-off point with some guidance for library authors: @zod/core
docs
Don't hesitate to reach out for help/guidance!
- Post to the #zod4 channel on the Discord
- Open an issue/discussion on the repo
- DM me on Discord or X
Activity
colinhacks commentedon May 14, 2025
Here's a dedicated guide for library authors that answers some common questions: https://v4.zod.dev/library-authors
Note that the
@zod/core
package has been abandoned in favor of a subpath:zod/v4/core
. This makes it much easier for libraries with build on top of Zod with a single peer dependency on"zod"
. The reasons for this change are explained in more detail in the beta announcement: https://v4.zod.dev/v4cc @J-Michalek these changes will impact your existing work over at #5032. sorry for the inconvenience!
hyshka commentedon May 28, 2025
Zod 4 is now stable. We can update the title of this issue to reflect that.
logaretm commentedon Jun 7, 2025
Handled by #5051 which will be tagged in v5
[-]Support for Zod 4 (now in beta)[/-][+]Support for Zod 4[/+]