UI Components

Modal

Accessible dialog overlay with backdrop, ESC close, body scroll lock, and composable sub-components

Quick Preview

Installation

// Copy the Modal component from
src/components/ui/Modal.tsx

Usage

'use client'
import { useState } from 'react'
import { Modal, ModalHeader, ModalBody, ModalFooter } from '@/components/ui/Modal'
import { Button } from '@/components/ui/Button'

export default function Example() {
  const [open, setOpen] = useState(false)

  return (
    <>
      <Button onClick={() => setOpen(true)}>Open Modal</Button>
      <Modal isOpen={open} onClose={() => setOpen(false)}>
        <ModalHeader>
          <h2 className="text-lg font-semibold">Title</h2>
        </ModalHeader>
        <ModalBody>
          <p className="text-gray-600 text-sm">Modal content goes here.</p>
        </ModalBody>
        <ModalFooter>
          <Button variant="ghost" onClick={() => setOpen(false)}>Cancel</Button>
          <Button onClick={() => setOpen(false)}>Confirm</Button>
        </ModalFooter>
      </Modal>
    </>
  )
}

Examples

Confirm / Destructive Dialog

Size Variants

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a ui component named Modal in React/Next.js.
Goal: recreate the same overall UI and behavior as the Modal reference from a component gallery.
What it needs to communicate: Accessible dialog overlay with backdrop, ESC close, body scroll lock, and composable sub-components.

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- isOpen: boolean — required — Controls dialog visibility
- onClose: () => void — required — Called when the modal should close
- size: "sm" | "md" | "lg" | "xl" | "full" — default "md" — Dialog width preset
- closeOnBackdrop: boolean — default true — Close when clicking the backdrop
- closeOnEsc: boolean — default true — Close on Escape key press
- className: string — Additional CSS classes for the dialog panel

Reference usage patterns:
- Basic Modal

```tsx
<Modal isOpen={open} onClose={() => setOpen(false)}><ModalBody>Content</ModalBody></Modal>
```

- Confirm Dialog

```tsx
<Modal isOpen={open} onClose={cancel} size="sm"><ModalBody>Are you sure?</ModalBody><ModalFooter><Button onClick={cancel}>Cancel</Button><Button variant="primary" onClick={confirm}>Confirm</Button></ModalFooter></Modal>
```

Feature expectations:
- Portal rendering into document.body
- ESC key to close
- Backdrop click to close
- Body scroll lock when open
- Auto-focuses close button on open
- ModalHeader / ModalBody / ModalFooter sub-components
- aria-modal + role="dialog"
- Five size presets
- Client Component

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Sub-components ModalHeader, ModalBody, and ModalFooter accept children and className.

Prop	Type	Default	Description
`isOpen`*	`boolean`	-	Controls dialog visibility
`onClose`*	`() => void`	-	Called when the modal should close
`size`	`"sm" \| "md" \| "lg" \| "xl" \| "full"`	`"md"`	Dialog width preset
`closeOnBackdrop`	`boolean`	`true`	Close when clicking the backdrop
`closeOnEsc`	`boolean`	`true`	Close on Escape key press
`className`	`string`	-	Additional CSS classes for the dialog panel

Features

✓Portal rendering into document.body
✓ESC key to close
✓Backdrop click to close
✓Body scroll lock when open
✓Auto-focuses close button on open
✓ModalHeader / ModalBody / ModalFooter sub-components
✓aria-modal + role="dialog"
✓Five size presets
✓Client Component