Textarea
Freev1.0.0The shadcn Textarea, plus an auto-growing field with a token count for prompts.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { TextareaField } from "@/components/ui/notchset/textarea";
export function TextareaExample() {
return (
<TextareaField label="System prompt" meta="Planner v14" costPerToken={0.0000004} helper="Sent before every run" focusHelper="Saved as draft" />
);
}Props
Textarea–as shadcnThe bare textarea (it sizes to its content).
TextareaField label / meta–ReactNodeThe label and a reading on the right.
value / defaultValue / onValueChange–string / (value) => voidThe value.
minHeight / maxHeight–numberAuto-grow bounds. Default 96 and 220; past the maximum it scrolls.
tokenLimit–numberThe meter's limit. Default 2000.
estimateTokens–(text) => numberDefault ceil(chars / 4).
Show all 8 propsShow fewer
costPerToken–numberShows the cost per run.
helper / focusHelper–stringThe helper, and the helper while focused.
Anatomy
- Same exports as shadcn's Textarea, plus TextareaField.
- No primitive needed: one file serves both builds.
- The Notchset instrument parts: node and glyph flip.
Textareadata-slot="textarea"The textarea.
TextareaFielddata-slot="textarea-field"The instrument's box.
Footerdata-slot="textarea-footer"The token meter, estimate and cost.
Source
components/ui/notchset/textarea.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/textarea.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/textarea.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/textarea.tsx
- lib/beautiful-ui/notchset/field.tsx
- lib/beautiful-ui/notchset/field-classes.ts
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Prompts, notes and anything longer than a line
- TextareaField when the length matters (tokens, cost)
Use something else when
- One line: use Input
Mistakes to avoid
- Tokens are an estimate: pass estimateTokens for your model's tokenizer
Agents find it by
- textarea, prompt editor, system prompt, multi-line input, token count, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/textarea.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- Tab
- Into and out of the field (no traps)
Accessibility
- A real <label>; the meter line is aria-describedby
- The estimate turns signal past 90% of the limit, in words as well as colour
Motion
- Grow
- The box animates to its content over 200ms cubic-bezier(.16,1,.3,1), clamped 96–220px
- Meter
- Dots bloom (r 1.1 → 1.6) over 260ms as the estimate rises
- Focus
- The ink trace draws from the left; the helper flips
Responsive
- Fills its container and grows with its rows; the footer wraps its helper under the count when narrow.
Performance
- A native textarea; the counter updates on change, nothing runs while idle.
Changelog
v1.0.0 · 2026-10-02
First release
