Zod Complete Documentation

Complete Zod validation library documentation. Use when working with Zod schema validation, TypeScript type inference, form validation, API validation, error handling, or data parsing. Covers schema definition, refinements, transforms, error customization, and ecosystem integrations.

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 Reference

• 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

Advanced Features

• 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

Integration & Ecosystem

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

Version 4

• v4/ - Zod v4 features and migration guide

Quick Reference

Common Tasks

Task	File to Read
Get started	index.mdx, basics.mdx
Define schemas	api.mdx (Primitives section)
Object validation	api.mdx (Objects section)
Array validation	api.mdx (Arrays section)
Union types	api.mdx (Unions section)
Refinements	api.mdx (Refinements section)
Transforms	api.mdx (Transforms section)
Error handling	error-formatting.mdx, error-customization.mdx
Type inference	api.mdx (Type Inference section)
Async validation	api.mdx (Async section)
JSON Schema	json-schema.mdx
Custom errors	error-customization.mdx
Ecosystem	ecosystem.mdx

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

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

All files are .mdx (Markdown + JSX) but readable as plain markdown.