Zod Documentation

Complete Zod validation library documentation embedded in markdown. Read from references/ to answer questions about schema validation, type inference, and error handling.

Documentation Structure

All documentation is in references/ organized by topic:

Core Documentation

#### Getting Started

• index.mdx - Introduction and quick start
• basics.mdx - Basic usage and schema definition

• api.mdx - Complete API documentation
• Primitives (string, number, boolean, etc.)
• Complex types (object, array, tuple, union, etc.)
• Schema methods (parse, safeParse, parseAsync, etc.)
• Refinements and transforms
• Type inference
• Error handling

• error-formatting.mdx - Error formatting and customization
• error-customization.mdx - Custom error messages
• codecs.mdx - Serialization and deserialization
• json-schema.mdx - JSON Schema generation
• metadata.mdx - Schema metadata

• ecosystem.mdx - Community packages and integrations
• library-authors.mdx - Guide for library authors
• packages/ - Related packages

• v4/ - Zod v4 features and migration guide

Quick Reference

Common Tasks

Schema Examples

Primitives:

z.string()
z.number()
z.boolean()
z.date()
z.undefined()
z.null()
z.any()
z.unknown()

Complex Types:

z.object({ ... })
z.array(z.string())
z.tuple([z.string(), z.number()])
z.union([z.string(), z.number()])
z.record(z.string())
z.map(z.string(), z.number())
z.set(z.string())

Refinements:

z.string().email()
z.string().url()
z.string().uuid()
z.number().min(5).max(10)
z.string().regex(/pattern/)

Transforms:

z.string().transform(val => val.toUpperCase())
z.coerce.number()

When to Use This Skill

• Form validation in React/Next.js
• API request/response validation
• Environment variable parsing
• Runtime type checking
• Data transformation and parsing
• Error message customization
• Integration with tRPC, React Hook Form, etc.
• TypeScript type inference from schemas

How to Navigate

• Start with index.mdx for introduction
• For basic usage: Read basics.mdx
• For API details: Check api.mdx (comprehensive reference)
• For error handling: See error-formatting.mdx and error-customization.mdx
• For advanced features: Browse codecs.mdx, json-schema.mdx, metadata.mdx
• For integrations: Check ecosystem.mdx
• For v4 features: See v4/ directory