Enabling ZOD TypeScript-first schema validation

zod is not included in the package, so you have to install it manually.

First of all install zod to enable the ZOD plugin.

npm install --save zod

Define the ZOD schema

const $schema = z.object({
	products: z.array(
		z.object({
			name: z.string().min(3),
			qty: z.number().min(0),
			amount: z.number().min(0),
		}))
		.optional(),
})

Define a plugins object

Pass the ZOD package and the previously defined schema to the ZOD plugin.

import zod from 'mobx-formkit/lib/validators/ZOD';
import z from 'zod';

const plugins = {
  zod: zod({
    package: z,
    schema: $schema,
    extend: ({ validator, form }) => {
      ... // access zod validator and form instances
    },
  })
};

Create the form passing the plugins object

new Form({ ... }, { plugins });

Note: ZOD does not support the extend callback or async validation pipelines through mobx-formkit's plugin system. For custom validation and async rules, use ZOD's native .refine() or .superRefine() methods on the schema directly.

ZOD versions

The ZOD driver supports zod v3.25+ and v4 (peer ^3.25.0 || ^4.0.0, optional peer; devDep in repo). The driver relies only on safeParse + error.format(), stable across both majors. For v4 smaller bundles use zod/v4/core.