Zod v4 Handbook

Purpose

Use this as the single source of truth for Zod 4 usage in this repository. Keep lookup cheap: route to one file first, then follow See also only if that file is not enough.

Routing Rules

• Do not read this handbook linearly.
• Pick exactly one target file first.
• Start with a sections/*.md file for broad tasks.
• Start with a topics/*.md file for narrow API questions.
• Follow See also only when the first file is insufficient.
• Ignore release notes, versioning, migration, and library-author internals unless the user explicitly asks for them.

Quick Picks (Task -> File)

• Define a first schema, parse data, infer types -> sections/00-basics.md
• Choose a primitive or literal schema -> sections/10-primitives.md
• Validate string formats like email, UUID, URL, ISO datetime -> topics/string-formats.md
• Build or reshape object schemas -> topics/object-shape-control.md
• Validate arrays, tuples, records, maps, or sets -> topics/collection-types.md