secondsky/claude-skills / plugins/react-hook-form-zod/skills/react-hook-form-zod
react-hook-form-zod
VerifiedType-safe React forms with React Hook Form and Zod validation. Use for form schemas, field arrays, multi-step forms, or encountering validation errors, resolver issues, nested field problems.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.6 KB |
| references/accessibility.md | markdown | 6.3 KB |
| references/error-handling.md | markdown | 5.0 KB |
| references/links-to-official-docs.md | markdown | 5.6 KB |
| references/performance-optimization.md | markdown | 6.6 KB |
| references/rhf-api-reference.md | markdown | 7.6 KB |
| references/shadcn-integration.md | markdown | 7.5 KB |
| references/top-errors.md | markdown | 7.6 KB |
| references/zod-schemas-guide.md | markdown | 7.7 KB |
| scripts/check-versions.shexecutable | script | 1.2 KB |
| templates/advanced-form.tsx | other | 13.1 KB |
| templates/async-validation.tsx | other | 11.5 KB |
| templates/basic-form.tsx | other | 7.8 KB |
| templates/custom-error-display.tsx | other | 9.7 KB |
| templates/dynamic-fields.tsx | other | 9.8 KB |
| templates/multi-step-form.tsx | other | 12.2 KB |
| templates/package.json | manifest | 772 B |
| templates/server-validation.tsx | other | 8.0 KB |
| templates/shadcn-form.tsx | other | 10.5 KB |
references/zod-schemas-guide.md
View on GitHub# Comprehensive Zod Schemas Guide
Complete reference for all Zod schema types and patterns.
---
## Primitives
```typescript
// String
z.string()
z.string().min(3, "Min 3 characters")
z.string().max(100, "Max 100 characters")
z.string().length(10, "Exactly 10 characters")
z.email({ error: "Invalid email" })
z.url({ error: "Invalid URL" })
z.uuid({ error: "Invalid UUID" })
z.string().regex(/pattern/, "Does not match pattern")
z.string().trim() // Trim whitespace
z.string().toLowerCase() //Convert to lowercase
z.string().toUpperCase() // Convert to uppercase
// Number
z.number()
z.number().int("Must be integer")
z.number().positive("Must be positive")
z.number().negative("Must be negative")
z.number().min(0, "Min is 0")
z.number().max(100, "Max is 100")
z.number().multipleOf(5, "Must be multiple of 5")
z.number().finite() // No Infinity or NaN
z.number().safe() // Within JS safe integer range
// Boolean
z.boolean()
// Date
z.date()
z.date().min(new Date("2020-01-01"), "Too old")
z.date().max(new Date(), "Cannot be in future")
// BigInt
z.bigint()
```
---
## Objects
```typescript
// Basic object
const userSchema = z.object({
name: z.string(),
age: z.number(),
})
// Nested object
const profileSchema = z.object({
user: userSchema,
address: z.object({
street: z.string(),
city: z.string(),
}),
})
// Partial (all fields optional)
const partialUserSchema = userSchema.partial()
// Deep Partial (recursively optional)
const deepPartialSchema = profileSchema.deepPartial()
// Pick specific fields
const nameOnlySchema = userSchema.pick({ name: true })
// Omit specific fields
const withoutAgeSchema = userSchema.omit({ age: true })
// Merge objects
const extendedUserSchema = userSchema.merge(z.object({
email: z.email(),
}))
// Passthrough (allow extra fields)
const passthroughSchema = userSchema.passthrough()
// Strict (no extra fields)
const strictSchema = userSchema.strict()
// Catchall (type for extra fields)
const catchallSchema = userSchema.catchall(z.string())
```
---
## Arrays
```typescript
// Array of strings
z.array(z.string())
// With length constraints
z.array(z.string()).min(1, "At least one item required")
z.array(z.string()).max(10, "Max 10 items")
z.array(z.string()).length(5, "Exactly 5 items")
z.array(z.string()).nonempty("Array cannot be empty")
// Array of objects
z.array(z.object({
name: z.string(),
age: z.number(),
}))
```
---
## Tuples
```typescript
// Fixed-length array with specific types
z.tuple([z.string(), z.number(), z.boolean()])
// With rest
z.tuple([z.string(), z.number()]).rest(z.boolean())
```
---
## Enums and Literals
```typescript
// Enum
z.enum(['red', 'green', 'blue'])
// Native enum
enum Color { Red, Green, Blue }
z.nativeEnum(Color)
// Literal
z.literal('hello')
z.literal(42)
z.literal(true)
```
---
## Unions and Discriminated Unions
```typescript
// Union
z.union([z.string(), z.number()])
// Discriminated union (recommended for better errors)
z.discriminatedUnion('type', [
z.object({ type: z.literal('user'), name: z.string() }),
z.object({ type: z.literal('admin'), permissions: z.array(z.string()) }),
])
```
---
## Optional and Nullable
```typescript
// Optional (value | undefined)
z.string().optional()
z.optional(z.string()) // Same as above
// Nullable (value | null)
z.string().nullable()
z.nullable(z.string()) // Same as above
// Nullish (value | null | undefined)
z.string().nullish()
```
---
## Default Values
```typescript
z.string().default('default value')
z.number().default(0)
z.boolean().default(false)
z.array(z.string()).default([])
```
---
## Refinements (Custom Validation)
```typescript
// Basic refinement
z.string().refine((val) => val.length > 5, {
message: "String must be longer than 5 characters",
})
// With custom path
z.object({
password: z.string(),
confirmPassword: z.string(),
}).refine((data) => data.password === data.confirmPassword, {
message: "Passwords don't match",
path: ['confirmPassword'],
})
// Multiple refinements
z.string()
.refine((val) => val.length >= 8, "Min 8 characters")
.refine((val) => /[A-Z]/.test(val), "Must contain uppercase")
.refine((val) => /[0-9]/.test(val), "Must contain number")
// Async refinement
z.string().refine(async (val) => {
const available = await checkAvailability(val)
return available
}, "Already taken")
```
---
## Transforms
```typescript
// String to number
z.string().transform((val) => parseInt(val, 10))
// Trim whitespace
z.string().transform((val) => val.trim())
// Parse date
z.string().transform((val) => new Date(val))
// Chain transform and refine
z.string()
.transform((val) => parseInt(val, 10))
.refine((val) => !isNaN(val), "Must be a number")
```
---
## Preprocess
```typescript
// Process before validation
z.preprocess(
(val) => (val === '' ? undefined : val),
z.string().optional()
)
// Convert to number
z.preprocess(
(val) => Number(val),
z.number()
)
```
---
## Intersections
```typescript
const baseUser = z.object({ name: z.string() })
const withEmail = z.object({ email: z.email() })
// Intersection (combines both)
const userWithEmail = baseUser.and(withEmail)
// OR
const userWithEmail = z.intersection(baseUser, withEmail)
```
---
## Records and Maps
```typescript
// Record (object with dynamic keys)
z.record(z.string()) // { [key: string]: string }
z.record(z.string(), z.number()) // { [key: string]: number }
// Map
z.map(z.string(), z.number())
```
---
## Sets
```typescript
z.set(z.string())
z.set(z.number()).min(1, "At least one item")
z.set(z.string()).max(10, "Max 10 items")
```
---
## Promises
```typescript
z.promise(z.string())
z.promise(z.object({ data: z.string() }))
```
---
## Custom Error Messages
In Zod 4, error customization is unified under the `error` parameter (replaces
the v3 `message`, `invalid_type_error`, `required_error`, and `errorMap` options).
Error callbacks return a bare `string` (or `undefined` to defer), not `{ message }`.
```typescript
// Field-level (unified error param)
z.string({ error: "Name is required" })
z.number({ error: "Must be a number" })
// Validation-level
z.string().min(3, "Min 3 characters")
z.email({ error: "Invalid email format" })
// Custom error callback (returns string, not { message })
z.string({
error: (issue) => {
if (issue.code === "invalid_type") {
return "Please enter text"
}
return undefined // defer to default
},
})
// Global defaults via z.config (replaces v3 z.setErrorMap)
z.config({
customError: (issue) => `Validation failed: ${issue.code}`,
})
```
---
## Type Inference
```typescript
const userSchema = z.object({
name: z.string(),
age: z.number(),
})
// Infer TypeScript type
type User = z.infer<typeof userSchema>
// Result: { name: string; age: number }
// Input type (before transforms)
type UserInput = z.input<typeof transformSchema>
// Output type (after transforms)
type UserOutput = z.output<typeof transformSchema>
```
---
## Parsing Methods
```typescript
// .parse() - throws on error
const result = schema.parse(data)
// .safeParse() - returns result object
const result = schema.safeParse(data)
if (result.success) {
console.log(result.data)
} else {
console.error(result.error)
}
// .parseAsync() - async validation
const result = await schema.parseAsync(data)
// .safeParseAsync() - async with result object
const result = await schema.safeParseAsync(data)
```
---
## Error Handling
```typescript
try {
schema.parse(data)
} catch (error) {
if (error instanceof z.ZodError) {
// Treeified errors (replaces v3 error.format())
console.log(z.treeifyError(error))
// Flattened errors (replaces v3 error.flatten())
console.log(z.flattenError(error))
// Individual issues
console.log(error.issues)
}
}
```
---
**Official Docs**: https://zod.dev
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |