For AI agents: the documentation index is at /llms.txt, and any docs page is available as Markdown by appending .md to its URL.

Approval

Verified

An inline approve or deny prompt for an agent's pending action.

Allow deleteFile to remove report.pdf?

When to use

Use when: Asking the person to allow a tool or action before the agent runs it.
Avoid when: Confirming ordinary form actions; use Alert Dialog.

Installation

bunx shelf add approval

The source lands in src/components/ui/approval.tsx, along with any Shelf items it builds on, and .shelf/lock.json records what was installed. It's yours to edit.

Usage

import { Approval } from "@/components/ui/approval";

<Approval />

Built on

Packages: @stylexjs/stylex
Shelf items: Button, foundations, utils
Figma: Optional native Figma library. See Designers.

Verified

Size: 0.9 kB gzipped on its own, 8.0 kB with the Shelf items and packages it builds on. JS and CSS in a production build, without React.
Accessibility: Axe passes on 1 story
Behavior: 1 interaction test in Storybook
React Compiler: Compiles with React Compiler
React Doctor: React Doctor finds nothing