## Installation [#installation]
npm
pnpm
yarn
bun
```bash
npx shadcn@latest add @dotui/checkbox-group
```
```bash
pnpm dlx shadcn@latest add @dotui/checkbox-group
```
```bash
yarn dlx shadcn@latest add @dotui/checkbox-group
```
```bash
bun x shadcn@latest add @dotui/checkbox-group
```
## Usage [#usage]
Use `CheckboxGroup` to allow users to select multiple items from a list of options.
```tsx
import { CheckboxGroup } from '@/components/ui/checkbox-group'
import { Checkbox, CheckboxControl } from '@/components/ui/checkbox'
import { FieldGroup, Label } from '@/components/ui/field'
```
```tsx
```
## Selection [#selection]
Use `defaultValue` for uncontrolled checkbox groups, or `value` and `onChange` for controlled checkbox groups.
```tsx
{/* ... */}
```
```tsx
const [frameworks, setFrameworks] = useState(['nextjs'])
;
{/* ... */}
```
## Examples [#examples]
## API Reference [#api-reference]
### CheckboxGroup [#checkboxgroup]
### Checkbox [#checkbox]