Forms

Radio Group

Accessible radio button group using fieldset and legend, with vertical and horizontal orientations

Quick Preview

Select a learning track

Foundation

Production

Professional Systems

Installation

// Copy the RadioGroup component from
src/components/forms/RadioGroup.tsx

Usage

'use client'
import { useState } from 'react'
import { RadioGroup } from '@/components/forms/RadioGroup'

const tracks = [
  { value: 'foundation', label: 'Foundation' },
  { value: 'production', label: 'Production' },
  { value: 'systems', label: 'Professional Systems' },
]

export default function Example() {
  const [track, setTrack] = useState('production')
  return (
    <RadioGroup
      name="track"
      options={tracks}
      value={track}
      onValueChange={setTrack}
      legend="Select a learning track"
    />
  )
}

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a forms component named Radio Group in React/Next.js.
Goal: recreate the same overall UI and behavior as the Radio Group reference from a component gallery.
What it needs to communicate: Accessible radio button group using fieldset and legend, with vertical and horizontal orientations.

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Support label, helper, error, disabled, and validation states.
- Ensure keyboard usability and accessible form semantics.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- options: RadioOption[] — required — Array of { value, label, description?, disabled? }
- value: string — Currently selected value
- onValueChange: (value: string) => void — Selection change handler
- name: string — required — HTML name for the radio group
- legend: string — Accessible group label (fieldset legend)
- orientation: "vertical" | "horizontal" — default "vertical" — Layout orientation
- size: "sm" | "md" | "lg" — default "md" — Radio and label size
- disabled: boolean — default false — Disable the entire group

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- fieldset + legend for screen readers
- Vertical and horizontal orientations
- Per-option disabled state
- Three sizes
- Keyboard navigable
- Client Component

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`options`*	`RadioOption[]`	-	Array of { value, label, description?, disabled? }
`value`	`string`	-	Currently selected value
`onValueChange`	`(value: string) => void`	-	Selection change handler
`name`*	`string`	-	HTML name for the radio group
`legend`	`string`	-	Accessible group label (fieldset legend)
`orientation`	`"vertical" \| "horizontal"`	`"vertical"`	Layout orientation
`size`	`"sm" \| "md" \| "lg"`	`"md"`	Radio and label size
`disabled`	`boolean`	`false`	Disable the entire group

Features

✓fieldset + legend for screen readers
✓Vertical and horizontal orientations
✓Per-option disabled state
✓Three sizes
✓Keyboard navigable
✓Client Component

Radio Group

Quick Preview

Installation

Usage

Examples

With Description

Horizontal Orientation

Sizes

Disabled

Copy a prompt that recreates this UI

Props

Features