# AGENTS.md — shadcn/ui

## Setup

- `components.json` at the root defines `style`, `rsc`, `baseColor`, `cssVariables`, and aliases (`@/components`, `@/lib/utils`).
- Components are copied into `components/ui` via `npx shadcn@latest add <name>` — they are your code.

## Conventions

- Merge classes with `cn()` (clsx + tailwind-merge); use `cva` for variants exposed through props.
- Build on Radix primitives; keep `"use client"` on interactive components; icons from `lucide-react`.
- Style with semantic tokens (`bg-background`, `text-foreground`, …) backed by CSS variables.
- Forward `className` + `...props` so components stay composable.

## Banned

- Wrapping or npm-packaging the generated `components/ui` instead of editing them.
- Manual class-string concatenation instead of `cn()`.
- Hardcoded raw colors that bypass theme tokens.
- Reimplementing Radix behavior by hand or stripping `"use client"`.