# Shadcn Basic

> Basic textarea.

- Type: example, free and open source (MIT)
- Component: [Textarea](https://reui.io/components/textarea.md)
- Page: https://reui.io/components/textarea/c-textarea-1
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/textarea.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/textarea.md
- MCP: `get_example("c-textarea-1")`
- Registry item: https://reui.io/r/styles/base-nova/c-textarea-1.json
- Uses: Textarea

## Best for

The bare multi line box with placeholder text and no label, Field or hint around it

## Agent notes

- Only the `placeholder` names this `Textarea`, and it clears once typing starts; add a visible label as `c-textarea-3` does

## When not to use

- A box drawn in its red error state after a failed check: use [Invalid](https://reui.io/components/textarea/c-textarea-2.md) (`get_example("c-textarea-2")`)
- A message box that carries its own Cancel and Post Comment buttons: use [Input Group](https://reui.io/components/input-group.md) (`get_component("input-group")`)

## Install

```bash
npx shadcn@latest add @reui/c-textarea-1
```

## About Shadcn Textarea

### When to use

- Messages, feedback and other free text answers that run over several lines
- Labeled long text fields with a hint under the box, an error state or a disabled state
- Profile bios that count characters toward a limit and grow as the user types

### When not to use

- A comment or prompt box with buttons or a live count inside its border: use [Input Group](https://reui.io/components/input-group.md) (`get_component("input-group")`)
- A modal that asks for a note along with reasons to tick, such as a churn survey: use the [Dialog blocks](https://reui.io/blocks/application/dialog.md)
- A complete page of fields, such as a support ticket or a profile edit, saved together: use the [Form blocks](https://reui.io/blocks/application/form.md)

### Agent notes

- `Textarea` grows with its text through `field-sizing-content` with no height cap, and Chromium ignores `rows`; set min-h and max-h classes
- Only `aria-invalid` on `Textarea` turns its border red, in every style; a data-invalid flag on `Field` leaves the border as it was

Every ReUI item has a twin like this one; the index is https://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.
