# Checkbox Group

> Multiple checkboxes collected into a string array with a min-selection rule.

A shadcn/ui block from the [@flx](https://ui.flexnative.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/flx/tsf-fields-05).

- Page, with a live preview: https://shadcn.exchange/r/flx/tsf-fields-05
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/flx/tsf-fields-05-light-1f476ada8d58bf4b.png
- Registry item: https://ui.flexnative.com/r/tsf-fields-05.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://ui.flexnative.com/r/tsf-fields-05.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `@tanstack/react-form`, `sonner`, `zod`
- Registry items: `field`, `checkbox`, `button`

## Files

### `registry/forms/tanstack-form/fields/tsf-fields-05.tsx`

```tsx
'use client'

import { useForm } from '@tanstack/react-form'
import { toast } from 'sonner'
import * as z from 'zod'

import { Button } from '@/components/ui/button'
import { Checkbox } from '@/components/ui/checkbox'
import {
  Field,
  FieldContent,
  FieldError,
  FieldGroup,
  FieldLabel,
  FieldLegend,
  FieldSet,
} from '@/components/ui/field'

const ITEMS = [
  { id: 'product', label: 'Product updates' },
  { id: 'security', label: 'Security alerts' },
  { id: 'marketing', label: 'Marketing emails' },
] as const

const formSchema = z.object({
  topics: z.array(z.string()).min(1, 'Select at least one topic.'),
})

export function TsfFields05() {
  const form = useForm({
    defaultValues: { topics: [] as string[] },
    validators: { onSubmit: formSchema },
    onSubmit: async ({ value }) => {
      toast.success('Subscriptions saved', {
        description: value.topics.join(', '),
      })
    },
  })

  return (
    <form
      onSubmit={(e) => {
        e.preventDefault()
        form.handleSubmit()
      }}
      className="flex w-full max-w-sm flex-col gap-6"
    >
      <FieldGroup>
        <form.Field name="topics">
          {(field) => {
            const isInvalid =
              field.state.meta.isTouched && !field.state.meta.isValid
            return (
              <FieldSet data-invalid={isInvalid}>
                <FieldLegend>Email subscriptions</FieldLegend>
                <FieldGroup className="gap-2">
                  {ITEMS.map((item) => (
                    <Field key={item.id} orientation="horizontal">
                      <Checkbox
                        id={`${field.name}-${item.id}`}
                        checked={field.state.value.includes(item.id)}
                        onCheckedChange={(checked) =>
                          field.handleChange(
                            checked === true
                              ? [...field.state.value, item.id]
                              : field.state.value.filter((v) => v !== item.id),
                          )
                        }
                      />
                      <FieldContent>
                        <FieldLabel htmlFor={`${field.name}-${item.id}`}>
                          {item.label}
                        </FieldLabel>
                      </FieldContent>
                    </Field>
                  ))}
                </FieldGroup>
                {isInvalid && <FieldError errors={field.state.meta.errors} />}
              </FieldSet>
            )
          }}
        </form.Field>
      </FieldGroup>
      <Button type="submit" size="sm">
        Save
      </Button>
    </form>
  )
}
```