Zod v3 to v4

This is a codemod (a tool that automatically transforms code) for migrating from Zod v3 to v4.

The migration guide can be found at https://zod.dev/v4/changelog

Using this codemod

This assumes you have Node.js installed.

The first step for you is to upgrade your Zod version to v4. In doubt, check your package.json. Note that if you're using Zod through Astro v6, you don't need to upgrade Zod manually.

Then, you can use this codemod to automatically migrate your code from Zod v3 to v4 syntax.

This codemod also migrates .vue files containing Zod schemas.

Interactive CLI

You can run it with the following command:

npx zod-v3-to-v4

It will ask you for the path to your tsconfig.json file, and then it will go through all your files and migrate Zod v3 code to v4.

Non-interactive CLI

Alternatively, you can pass the path to your tsconfig.json file as an argument:

npx zod-v3-to-v4 path/to/your/tsconfig.json

This is useful if you ever need to run the codemod in script (e.g. in a CI pipeline).

Installing it as a package

You can also install it as a package and run it from your project:

npm install -ED zod-v3-to-v4

And then run it with:

npx zod-v3-to-v4

Reporting issues

If the codemod missed something or did something wrong, please open an issue.

Contributing

This project uses node.js and pnpm. To get started, run:

pnpm install

To run the tests, run:

pnpm test

We use ts-morph to parse and transform the code.

Useful links:

• ts-morph
• TS AST viewer
• vitest
• Zod v4 migration guide

Playground

If you want to test the codemod from CLI, you can use the playground folder. It contains a tsconfig.json file and some sample TypeScript files with Zod v3 code. You can run the codemod on these files with:

pnpm playground

Or interactively:

pnpm playground:interactive
# Then enter: playground/tsconfig.json

Contributors

Nicolas Carlo 🤔 💻 📖 👀 💬	HiDeoo 🤔 💻	Gajus Kuizinas 🤔	Kirill Loskutov 🐛	Schrubitteflau 🤔 💻	Erik 🐛	Einar Guðni Guðjónsson 🐛
Daniel Ugbeye 🤔	Kevin Firko 🐛 🤔	Greg Sims 🐛	PowerSupply 🐛	Christophe Frèrebeau 🐛	aelligsen 🤔	Nikolaus Z 🐛
Bastien Jorge 🐛	Daniel Friesen 🐛	Marvin Affeldt 🤔	Abdullah Alaqeel 🐛	Wonder Woman 🐛	nzhiti 🤔	Simon Roberts 🐛
yann-combarnous 🐛	acdoussan 🐛	Mats Julius Funke 🤔	popfendi 🐛	Luís Azevedo 🤔 🐛	Florian Lefebvre 🐛 🤔 👀	Robert Cooper 🐛
Khiet Tam Nguyen 🤔	Neil Richter 🤔	Jeremy Bogatirsky 💻	Greg W 🐛	paulrudy 🐛	Tiago tms Silveira 🐛	M. Hossein Zendehpey 🐛
Arun Kumar 🤔
Add your contributions