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/dynamic-fields.tsx

View on GitHub
/**
 * Dynamic Form Fields Example - useFieldArray
 *
 * Demonstrates:
 * - useFieldArray for dynamic add/remove functionality
 * - Array validation with Zod
 * - Proper key usage (field.id, not index)
 * - Nested field error handling
 * - Add, remove, update, insert operations
 */

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

// Schema for contact list
const contactSchema = z.object({
  name: z.string().min(1, 'Name is required'),
  email: z.email({ error: 'Invalid email' }),
  phone: z.string().regex(/^\+?[1-9]\d{1,14}$/, 'Invalid phone number').optional(),
  isPrimary: z.boolean().optional(),
})

const contactListSchema = z.object({
  contacts: z.array(contactSchema)
    .min(1, 'At least one contact is required')
    .max(10, 'Maximum 10 contacts allowed'),
})

type ContactListData = z.infer<typeof contactListSchema>

export function DynamicContactList() {
  const {
    register,
    control,
    handleSubmit,
    formState: { errors },
  } = useForm<ContactListData>({
    resolver: zodResolver(contactListSchema),
    defaultValues: {
      contacts: [{ name: '', email: '', phone: '', isPrimary: false }],
    },
  })

  const { fields, append, remove, insert, update } = useFieldArray({
    control,
    name: 'contacts',
  })

  const onSubmit = (data: ContactListData) => {
    console.log('Contacts:', data)
  }

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

      {/* Array error (min/max length) */}
      {errors.contacts && !Array.isArray(errors.contacts) && (
        <div role="alert" className="text-sm text-red-600 bg-red-50 p-3 rounded">
          {errors.contacts.message}
        </div>
      )}

      <div className="space-y-4">
        {fields.map((field, index) => (
          <div
            key={field.id} // IMPORTANT: Use field.id, not index
            className="border rounded-lg p-4 space-y-3"
          >
            <div className="flex justify-between items-center">
              <h3 className="font-medium">Contact {index + 1}</h3>
              <button
                type="button"
                onClick={() => remove(index)}
                className="text-red-600 hover:text-red-800 text-sm"
                disabled={fields.length === 1} // Require at least one contact
              >
                Remove
              </button>
            </div>

            {/* Name */}
            <div>
              <label htmlFor={`contacts.${index}.name`} className="block text-sm font-medium mb-1">
                Name *
              </label>
              <input
                id={`contacts.${index}.name`}
                {...register(`contacts.${index}.name` as const)}
                className="w-full px-3 py-2 border rounded-md"
              />
              {errors.contacts?.[index]?.name && (
                <span role="alert" className="text-sm text-red-600 mt-1 block">
                  {errors.contacts[index]?.name?.message}
                </span>
              )}
            </div>

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

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

            {/* Primary Contact Checkbox */}
            <div className="flex items-center">
              <input
                id={`contacts.${index}.isPrimary`}
                type="checkbox"
                {...register(`contacts.${index}.isPrimary` as const)}
                className="h-4 w-4 rounded"
              />
              <label htmlFor={`contacts.${index}.isPrimary`} className="ml-2 text-sm">
                Primary contact
              </label>
            </div>
          </div>
        ))}
      </div>

      {/* Add Contact Button */}
      <div className="flex gap-2">
        <button
          type="button"
          onClick={() => append({ name: '', email: '', phone: '', isPrimary: false })}
          disabled={fields.length >= 10}
          className="px-4 py-2 bg-green-600 text-white rounded-md hover:bg-green-700 disabled:bg-gray-400"
        >
          Add Contact
        </button>

        <button
          type="button"
          onClick={() => insert(0, { name: '', email: '', phone: '', isPrimary: false })}
          className="px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700"
        >
          Add at Top
        </button>
      </div>

      {/* Submit */}
      <button type="submit" className="w-full px-4 py-2 bg-indigo-600 text-white rounded-md hover:bg-indigo-700">
        Save Contacts
      </button>
    </form>
  )
}

/**
 * Advanced Example: Skills with Custom Add
 */
const skillSchema = z.object({
  name: z.string().min(1, 'Skill name is required'),
  level: z.enum(['beginner', 'intermediate', 'advanced', 'expert']),
  yearsOfExperience: z.number().int().min(0).max(50),
})

const skillsFormSchema = z.object({
  skills: z.array(skillSchema).min(1, 'Add at least one skill'),
})

type SkillsFormData = z.infer<typeof skillsFormSchema>

export function DynamicSkillsForm() {
  const { register, control, handleSubmit, formState: { errors } } = useForm<SkillsFormData>({
    resolver: zodResolver(skillsFormSchema),
    defaultValues: {
      skills: [],
    },
  })

  const { fields, append, remove } = useFieldArray({
    control,
    name: 'skills',
  })

  // Preset skill templates
  const addPresetSkill = (skillName: string) => {
    append({
      name: skillName,
      level: 'intermediate',
      yearsOfExperience: 1,
    })
  }

  const onSubmit = (data: SkillsFormData) => {
    console.log('Skills:', data)
  }

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

      {errors.skills && !Array.isArray(errors.skills) && (
        <div role="alert" className="text-sm text-red-600">
          {errors.skills.message}
        </div>
      )}

      {/* Preset Skills */}
      <div className="space-y-2">
        <h3 className="text-sm font-medium">Quick Add:</h3>
        <div className="flex flex-wrap gap-2">
          {['React', 'TypeScript', 'Node.js', 'Python', 'SQL'].map((skill) => (
            <button
              key={skill}
              type="button"
              onClick={() => addPresetSkill(skill)}
              className="px-3 py-1 bg-gray-200 rounded-full text-sm hover:bg-gray-300"
            >
              + {skill}
            </button>
          ))}
        </div>
      </div>

      {/* Skills List */}
      <div className="space-y-3">
        {fields.map((field, index) => (
          <div key={field.id} className="border rounded p-3 flex gap-3 items-start">
            <div className="flex-1 space-y-2">
              <input
                {...register(`skills.${index}.name` as const)}
                placeholder="Skill name"
                className="w-full px-2 py-1 border rounded text-sm"
              />
              {errors.skills?.[index]?.name && (
                <span className="text-xs text-red-600">{errors.skills[index]?.name?.message}</span>
              )}

              <div className="grid grid-cols-2 gap-2">
                <select
                  {...register(`skills.${index}.level` as const)}
                  className="px-2 py-1 border rounded text-sm"
                >
                  <option value="beginner">Beginner</option>
                  <option value="intermediate">Intermediate</option>
                  <option value="advanced">Advanced</option>
                  <option value="expert">Expert</option>
                </select>

                <input
                  type="number"
                  {...register(`skills.${index}.yearsOfExperience` as const, { valueAsNumber: true })}
                  placeholder="Years"
                  className="px-2 py-1 border rounded text-sm"
                />
              </div>
            </div>

            <button
              type="button"
              onClick={() => remove(index)}
              className="text-red-600 hover:text-red-800 text-sm px-2"
            >
              ✕
            </button>
          </div>
        ))}
      </div>

      {/* Custom Add */}
      <button
        type="button"
        onClick={() => append({ name: '', level: 'beginner', yearsOfExperience: 0 })}
        className="w-full px-4 py-2 border-2 border-dashed border-gray-300 rounded-md hover:border-gray-400 text-gray-600"
      >
        + Add Custom Skill
      </button>

      <button type="submit" className="w-full px-4 py-2 bg-indigo-600 text-white rounded-md hover:bg-indigo-700">
        Save Skills
      </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