Skip to content
GaudiGaudi Design System home

Search documentation

Search every page, heading and paragraph.

Dialog

Modal, confirmation and bare full-screen dialogs for editing, detail inspection, explicit decisions, lightboxes and launchers.

CoreOverlays & Menus@gaudi/design-system/core/DialogView in StorybookSource

Installation

pnpm add github:ahmadassaf/design-system

Import from @gaudi/design-system. Load @gaudi/design-system/global.css once and add transpilePackages: ['@gaudi/design-system'] in Next.js.

import Dialog from '@gaudi/design-system/core/Dialog';

Copy an example into your project with the shadcn CLI: npx shadcn@latest add https://design.gaudi.site/r/confirmation-checklist.json.

Usage

import Dialog from '@gaudi/design-system/core/Dialog';import Button from '@gaudi/design-system/core/Button';
<Dialog title='Edit profile' description='Update your public details.' trigger={<Button>Edit profile</Button>}> {profileForm}</Dialog>

Examples

Checklist before an action

Storybook

Confirmation with a don't-ask-again option

Storybook

Confirmation layouts

Storybook

Confirmation nested in a dialog

Storybook

Notice with a status badge

Storybook

Success summary with details

Storybook
Storybook

Form dialog

Storybook

Scrollable content

Storybook

Settings with switches

Storybook

Keyboard shortcuts list

Storybook

Drawer from each edge

Storybook

API

18 props

Accessibility

Focus stays in the dialog and returns to its trigger. Confirmation mode focuses Cancel and blocks dismissal while a decision is pending.

Notes

  • Use DialogClose for modal and sheet actions. Confirmation mode owns its actions and pending state; children and footer apply to modal and sheet variants.