Skip to content

secondsky/claude-skills / plugins/react-hook-form-zod/skills/react-hook-form-zod

react-hook-form-zod

Verified

Type-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.

templates/advanced-form.tsx

View on GitHub
/**
 * Advanced Form Example - User Profile with Nested Objects and Arrays
 *
 * Demonstrates:
 * - Nested object validation (address)
 * - Array field validation (skills)
 * - Conditional field validation
 * - Complex Zod schemas with refinements
 * - Type-safe nested error handling
 */

import { useForm } from 'react-hook-form'
import { zodResolver } from '@hookform/resolvers/zod'
import { z } from 'zod'

// Define nested schemas
const addressSchema = z.object({
  street: z.string().min(1, 'Street is required'),
  city: z.string().min(1, 'City is required'),
  state: z.string().min(2, 'State must be at least 2 characters'),
  zipCode: z.string().regex(/^\d{5}(-\d{4})?$/, 'Invalid ZIP code format'),
  country: z.string().min(1, 'Country is required'),
})

// Complex schema with nested objects and arrays
const profileSchema = z.object({
  // Basic fields
  firstName: z.string().min(2, 'First name must be at least 2 characters'),
  lastName: z.string().min(2, 'Last name must be at least 2 characters'),
  email: z.email({ error: 'Invalid email address' }),
  phone: z.string().regex(/^\+?[1-9]\d{1,14}$/, 'Invalid phone number').optional(),

  // Nested object
  address: addressSchema,

  // Array of strings
  skills: z.array(z.string().min(1, 'Skill cannot be empty'))
    .min(1, 'At least one skill is required')
    .max(10, 'Maximum 10 skills allowed'),

  // Conditional fields
  isStudent: z.boolean(),
  school: z.string().optional(),
  graduationYear: z.number().int().min(1900).max(2100).optional(),

  // Enum
  experience: z.enum(['junior', 'mid', 'senior', 'lead'], {
    error: () => 'Please select experience level',
  }),

  // Number with constraints
  yearsOfExperience: z.number()
    .int('Must be a whole number')
    .min(0, 'Cannot be negative')
    .max(50, 'Must be 50 or less'),

  // Date
  availableFrom: z.date().optional(),

  // Boolean
  agreedToTerms: z.boolean().refine((val) => val === true, {
    message: 'You must agree to the terms and conditions',
  }),
})
  .refine((data) => {
    // Conditional validation: if isStudent is true, school is required
    if (data.isStudent && !data.school) {
      return false
    }
    return true
  }, {
    message: 'School is required for students',
    path: ['school'],
  })
  .refine((data) => {
    // Experience level should match years of experience
    if (data.experience === 'senior' && data.yearsOfExperience < 5) {
      return false
    }
    return true
  }, {
    message: 'Senior level requires at least 5 years of experience',
    path: ['yearsOfExperience'],
  })

type ProfileFormData = z.infer<typeof profileSchema>

export function AdvancedProfileForm() {
  const {
    register,
    handleSubmit,
    watch,
    formState: { errors, isSubmitting },
    setValue,
  } = useForm<ProfileFormData>({
    resolver: zodResolver(profileSchema),
    defaultValues: {
      firstName: '',
      lastName: '',
      email: '',
      phone: '',
      address: {
        street: '',
        city: '',
        state: '',
        zipCode: '',
        country: 'USA',
      },
      skills: [''], // Start with one empty skill
      isStudent: false,
      school: '',
      experience: 'junior',
      yearsOfExperience: 0,
      agreedToTerms: false,
    },
  })

  // Watch isStudent to conditionally show school field
  const isStudent = watch('isStudent')

  const onSubmit = async (data: ProfileFormData) => {
    console.log('Profile data:', data)
    // API call
  }

  return (
    <form onSubmit={handleSubmit(onSubmit)} className="space-y-6 max-w-2xl mx-auto">
      <h2 className="text-3xl font-bold">User Profile</h2>

      {/* Basic Information */}
      <section className="space-y-4">
        <h3 className="text-xl font-semibold">Basic Information</h3>

        <div className="grid grid-cols-2 gap-4">
          <div>
            <label htmlFor="firstName" className="block text-sm font-medium mb-1">
              First Name *
            </label>
            <input
              id="firstName"
              {...register('firstName')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.firstName && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.firstName.message}
              </span>
            )}
          </div>

          <div>
            <label htmlFor="lastName" className="block text-sm font-medium mb-1">
              Last Name *
            </label>
            <input
              id="lastName"
              {...register('lastName')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.lastName && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.lastName.message}
              </span>
            )}
          </div>
        </div>

        <div>
          <label htmlFor="email" className="block text-sm font-medium mb-1">
            Email *
          </label>
          <input
            id="email"
            type="email"
            {...register('email')}
            className="w-full px-3 py-2 border rounded-md"
          />
          {errors.email && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.email.message}
            </span>
          )}
        </div>

        <div>
          <label htmlFor="phone" className="block text-sm font-medium mb-1">
            Phone (Optional)
          </label>
          <input
            id="phone"
            type="tel"
            {...register('phone')}
            placeholder="+1234567890"
            className="w-full px-3 py-2 border rounded-md"
          />
          {errors.phone && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.phone.message}
            </span>
          )}
        </div>
      </section>

      {/* Address (Nested Object) */}
      <section className="space-y-4">
        <h3 className="text-xl font-semibold">Address</h3>

        <div>
          <label htmlFor="street" className="block text-sm font-medium mb-1">
            Street *
          </label>
          <input
            id="street"
            {...register('address.street')}
            className="w-full px-3 py-2 border rounded-md"
          />
          {errors.address?.street && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.address.street.message}
            </span>
          )}
        </div>

        <div className="grid grid-cols-2 gap-4">
          <div>
            <label htmlFor="city" className="block text-sm font-medium mb-1">
              City *
            </label>
            <input
              id="city"
              {...register('address.city')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.address?.city && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.address.city.message}
              </span>
            )}
          </div>

          <div>
            <label htmlFor="state" className="block text-sm font-medium mb-1">
              State *
            </label>
            <input
              id="state"
              {...register('address.state')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.address?.state && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.address.state.message}
              </span>
            )}
          </div>
        </div>

        <div className="grid grid-cols-2 gap-4">
          <div>
            <label htmlFor="zipCode" className="block text-sm font-medium mb-1">
              ZIP Code *
            </label>
            <input
              id="zipCode"
              {...register('address.zipCode')}
              placeholder="12345 or 12345-6789"
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.address?.zipCode && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.address.zipCode.message}
              </span>
            )}
          </div>

          <div>
            <label htmlFor="country" className="block text-sm font-medium mb-1">
              Country *
            </label>
            <input
              id="country"
              {...register('address.country')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.address?.country && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.address.country.message}
              </span>
            )}
          </div>
        </div>
      </section>

      {/* Skills (Array - simplified for advanced-form, see dynamic-fields.tsx for full array handling) */}
      <section className="space-y-4">
        <h3 className="text-xl font-semibold">Skills</h3>
        <p className="text-sm text-gray-600">
          Enter skills separated by commas (handled as string for simplicity in this example)
        </p>
        <div>
          <label htmlFor="skills" className="block text-sm font-medium mb-1">
            Skills (comma-separated) *
          </label>
          <input
            id="skills"
            {...register('skills.0')} // Simplified - see dynamic-fields.tsx for proper array handling
            placeholder="React, TypeScript, Node.js"
            className="w-full px-3 py-2 border rounded-md"
          />
          {errors.skills && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.skills.message || errors.skills[0]?.message}
            </span>
          )}
        </div>
      </section>

      {/* Experience */}
      <section className="space-y-4">
        <h3 className="text-xl font-semibold">Experience</h3>

        <div>
          <label htmlFor="experience" className="block text-sm font-medium mb-1">
            Experience Level *
          </label>
          <select
            id="experience"
            {...register('experience')}
            className="w-full px-3 py-2 border rounded-md"
          >
            <option value="junior">Junior</option>
            <option value="mid">Mid-Level</option>
            <option value="senior">Senior</option>
            <option value="lead">Lead</option>
          </select>
          {errors.experience && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.experience.message}
            </span>
          )}
        </div>

        <div>
          <label htmlFor="yearsOfExperience" className="block text-sm font-medium mb-1">
            Years of Experience *
          </label>
          <input
            id="yearsOfExperience"
            type="number"
            {...register('yearsOfExperience', { valueAsNumber: true })}
            className="w-full px-3 py-2 border rounded-md"
          />
          {errors.yearsOfExperience && (
            <span role="alert" className="text-sm text-red-600 mt-1 block">
              {errors.yearsOfExperience.message}
            </span>
          )}
        </div>
      </section>

      {/* Conditional Fields */}
      <section className="space-y-4">
        <h3 className="text-xl font-semibold">Education</h3>

        <div className="flex items-center">
          <input
            id="isStudent"
            type="checkbox"
            {...register('isStudent')}
            className="h-4 w-4 rounded"
          />
          <label htmlFor="isStudent" className="ml-2 text-sm">
            I am currently a student
          </label>
        </div>

        {/* Conditional field - only show if isStudent is true */}
        {isStudent && (
          <div>
            <label htmlFor="school" className="block text-sm font-medium mb-1">
              School Name *
            </label>
            <input
              id="school"
              {...register('school')}
              className="w-full px-3 py-2 border rounded-md"
            />
            {errors.school && (
              <span role="alert" className="text-sm text-red-600 mt-1 block">
                {errors.school.message}
              </span>
            )}
          </div>
        )}
      </section>

      {/* Terms and Conditions */}
      <section className="space-y-4">
        <div className="flex items-start">
          <input
            id="agreedToTerms"
            type="checkbox"
            {...register('agreedToTerms')}
            className="h-4 w-4 rounded mt-1"
          />
          <label htmlFor="agreedToTerms" className="ml-2 text-sm">
            I agree to the terms and conditions *
          </label>
        </div>
        {errors.agreedToTerms && (
          <span role="alert" className="text-sm text-red-600 block">
            {errors.agreedToTerms.message}
          </span>
        )}
      </section>

      {/* Submit Button */}
      <button
        type="submit"
        disabled={isSubmitting}
        className="w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 disabled:bg-gray-400"
      >
        {isSubmitting ? 'Saving...' : 'Save Profile'}
      </button>
    </form>
  )
}
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall