Zod Schema Validation

When to Use

• Validating external data boundaries (API payloads, form input, env vars, config files)
• Creating a single source of truth for both runtime validation and TypeScript types
• Transforming data shape at system boundaries (e.g., snake_case API to camelCase internal)

When NOT to use:

• Internal types with no runtime boundary — use plain TypeScript interfaces
• Simple type narrowing that a type guard handles fine
• Performance-critical hot paths parsing thousands of objects per second — Zod adds measurable overhead

Our Conventions