react-hook-form-zod

Status : Production Ready ✅ Last Verified : 2026-01-20 Latest Versions : react-hook-form@7.71.1, zod@4.3.5, @hookform/resolvers@5.2.2 Basic Form Pattern : Server Validation (CRITICAL - never skip): useForm Options (validation modes): Zod Refinements (cross-field validation): Zod Transforms : Zod v4.3.0+ Features : zodResolver connects Zod to React Hook Form, preserving type safety register (for standard HTML inputs): Controller (for third-party components): When to use Controller : React Select, date pickers, custom components without ref. Otherwise use register . Display errors : Server errors : useFieldArray (dynamic lists): Async Validation (debounce): Multi-Step Forms : Conditional Validation : Conditional Fields with shouldUnregister : Note : shadcn/ui deprecated the Form component. Use the Field component for new implementations (check latest docs). Common Import Mistake : IDEs/AI may auto-import Form from "react-hook-form" instead of from shadcn. Always import: Legacy Form component : Warning : Forms with 300+ fields using a resolver (Zod/Yup) AND reading formState properties can freeze for 10-15 seconds during registration. ( Issue #13129 ) Performance Characteristics : Workarounds : ✅ Always set defaultValues (prevents uncontrolled→controlled warnings) ✅ Validate on BOTH client and server (client can be bypassed - security!) ✅ Use field.id as key in useFieldArray (not...