radkradk

Form

Accessible form field primitives built on react-hook-form with Zod validation.

This is your public display name.

Installation

npx radk-cli@latest add form

Also install the resolver:

npm install @hookform/resolvers zod

Usage

import { useForm } from "react-hook-form"
import { zodResolver } from "@hookform/resolvers/zod"
import { z } from "zod"
import {
  Form,
  FormControl,
  FormDescription,
  FormField,
  FormItem,
  FormLabel,
  FormMessage,
} from "@/components/ui/form"
const formSchema = z.object({
  username: z.string().min(2).max(50),
})

export function ProfileForm() {
  const form = useForm<z.infer<typeof formSchema>>({
    resolver: zodResolver(formSchema),
    defaultValues: { username: "" },
  })

  function onSubmit(values: z.infer<typeof formSchema>) {
    console.log(values)
  }

  return (
    <Form {...form}>
      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
        <FormField
          control={form.control}
          name="username"
          render={({ field }) => (
            <FormItem>
              <FormLabel>Username</FormLabel>
              <FormControl>
                <Input placeholder="shadcn" {...field} />
              </FormControl>
              <FormDescription>This is your public display name.</FormDescription>
              <FormMessage />
            </FormItem>
          )}
        />
        <Button type="submit">Submit</Button>
      </form>
    </Form>
  )
}

Components

ComponentDescription
FormWraps FormProvider from react-hook-form
FormFieldWraps Controller, provides field context
FormItemLayout wrapper providing unique IDs
FormLabelLabel wired to input via htmlFor, turns red on error
FormControlPasses id, aria-* to the underlying input
FormDescriptionHelper text below the input
FormMessageDisplays Zod/RHF error messages