# BlankUI

> A React 19 + Tailwind CSS v4 component library built for coding agents. Components are copied into your project (shadcn style) with a .md file next to each one.

Install: `npx blankui init`, then `npx blankui add <component>`. Registry items: https://blank.vageshwar.dev/r/<name>.json

## Layout

- [Layout](https://blank.vageshwar.dev/docs/layout.md): Stack, Inline, Grid and Container. Use them for all spacing between elements.

## Action

- [Button](https://blank.vageshwar.dev/docs/button.md): A clickable action. Supports variants, sizes, icon-only buttons, loading state and links.

## Form

- [Checkbox](https://blank.vageshwar.dev/docs/checkbox.md): A checkbox for a yes or no choice, or for picking several items from a list.
- [Field](https://blank.vageshwar.dev/docs/field.md): Wraps one form control with a label, help text and an error message, and wires up the accessibility attributes.
- [Input](https://blank.vageshwar.dev/docs/input.md): A single-line text input. Put it inside a Field for the label and errors.
- [Select](https://blank.vageshwar.dev/docs/select.md): A dropdown for picking one option from a list. Put it inside a Field for the label and errors.
- [Textarea](https://blank.vageshwar.dev/docs/textarea.md): A multi-line text input. Put it inside a Field for the label and errors.

## Overlay

- [Alert Dialog](https://blank.vageshwar.dev/docs/alert-dialog.md): A confirmation the user must answer, for destructive or important actions. Clicking outside does not close it.
- [Dialog](https://blank.vageshwar.dev/docs/dialog.md): A modal window for a focused task, like editing a record. Blocks the page until closed.
- [Popover](https://blank.vageshwar.dev/docs/popover.md): A small floating panel anchored to a button, for extra controls or details. Does not block the page.
- [Sheet](https://blank.vageshwar.dev/docs/sheet.md): A panel that slides in from an edge of the screen, for filters, settings, details or mobile navigation.
- [Tooltip](https://blank.vageshwar.dev/docs/tooltip.md): A short text hint shown on hover and keyboard focus. Includes its own provider.

## Feedback

- [Toast](https://blank.vageshwar.dev/docs/toast.md): A short message that appears for a few seconds after something happens, like "Saved". Built on sonner.

## Display

- [Card](https://blank.vageshwar.dev/docs/card.md): A bordered surface that groups related content, with header, content and footer parts.
- [Table](https://blank.vageshwar.dev/docs/table.md): A data table for rows of items with the same fields, like invoices or users.

## Navigation

- [Tabs](https://blank.vageshwar.dev/docs/tabs.md): Switch between views of related content in the same place, like Account and Billing settings.

## Optional

- [Everything in one file](https://blank.vageshwar.dev/llms-full.txt)
- [Design decisions](https://github.com/Vageshwar/blankui/blob/main/docs/SPEC.md)