# RadioCard

A native radio choice presented as a selectable content card.

Connect Flood once using [the installation guide](https://flood.md/docs/installation). Then import the components you use; no per-component add command is needed.

## Example

```tsx
"use client";

import { FloodRoot, Fieldset, Stack, RadioCard } from "@flood-md/react";
import "@flood-md/react/styles.css";

export function Example() {
  return (
    <FloodRoot>
      <Fieldset legend="Plan">
        <Stack gap="2">
          <RadioCard name="plan" value="starter" label="Starter" description="For your next idea." metadata="Free" defaultChecked />
          <RadioCard name="plan" value="team" label="Team" description="For working together." metadata="$12 / month" />
        </Stack>
      </Fieldset>
    </FloodRoot>
  );
}
```

## Design notes

- Group choices in a Fieldset and give them the same name.
- Native arrow-key behavior, forms and reset remain available. Apply readOnly consistently to the whole group.

## API reference

| Prop | Values | Default |
| --- | --- | --- |
| `label` | `string` | `Required` |
| `description` | `ReactNode` | `—` |
| `icon` | `ReactNode` | `—` |
| `metadata` | `ReactNode` | `—` |
| `density` | `"compact" \| "comfortable"` | `—` |
| `Native HTML props` | `Omit<Omit<InputHTMLAttributes<HTMLInputElement>, "type" \| "size">, "label" \| "children">` | `Forwarded` |
