# Overlay Dialog Stack

Stacked or nested dialogs where a settings dialog opens a confirmation on top.

- id: `overlay-dialog-stack`
- Page: https://agentic-ui-kit.com/components/overlay-dialog-stack
- Live preview: https://agentic-ui-kit.com/live/component/overlay-dialog-stack?piece=overlay-dialog-stack

## Install

```bash
agentic-ui add overlay-dialog-stack
npx shadcn@4.17.0 add @agentic-ui/overlay-dialog-stack
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** dialog-stack, nested-dialogs, dialog-manager, escape-order, focus-return, typed-confirmation, destructive-dialog, depth-limit, dark-mode
- **Intents:** execute-flow, configure
- **Suits domains:** saas, settings, operations, ai-agents, devtools
- **Interaction:** click, keyboard-navigation, typing, dismiss
- **Screen role:** flow
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** stacked or nested dialogs where a settings dialog opens a confirmation on top, destructive confirm dialog that requires typing the resource name to enable delete, dialog manager with a hook to open modals from anywhere with correct focus return, multi step modal flow where Escape closes one dialog at a time
- **Avoid when:** a single simple confirmation (use the alert dialog primitive or ai-action-confirmation), a side panel that does not block the page (use a sheet), a wizard with progress, where one dialog with steps is clearer, more than three levels of nesting, which signals a flow that needs its own page
- **Preserve when adapting:** escape-closes-top-only, focus-return-to-opener, typed-confirmation-exact-match, depth-limit
- **Replace when adapting:** dialog-specs, confirm-phrase, copy
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, dialog, input, label
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives