UI Components

Popover

An anchor-aware floating popover with auto-positioning, sub-components, and keyboard/click-outside dismissal.

Quick Preview

Installation

// Copy Popover.tsx to your components/ui/ folder
// src/components/ui/Popover.tsx

Usage

import { Popover, PopoverContent, PopoverHeader, PopoverFooter } from '@/components/ui/Popover'

<Popover trigger={<button>Open</button>}>
  <PopoverHeader><p>Title</p></PopoverHeader>
  <PopoverContent>
    <p>Your content here</p>
  </PopoverContent>
</Popover>

Examples

Positioning

Rich Content Popover

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 Popover in React/Next.js.
Goal: recreate the same overall UI and behavior as the Popover reference from a component gallery.
What it needs to communicate: An anchor-aware floating popover with auto-positioning, sub-components, and keyboard/click-outside dismissal..

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:
- trigger: React.ReactNode — required — Element that opens the popover on click
- children: React.ReactNode — required — Popover content
- side: "top" | "bottom" | "left" | "right" — default "bottom" — Preferred side to place the popover
- align: "start" | "center" | "end" — default "start" — Alignment relative to the trigger
- sideOffset: number — default 8 — Gap (px) between trigger and popover
- open: boolean — Controlled open state
- onOpenChange: (open: boolean) => void — Called when the open state changes

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- Auto-positioning with getBoundingClientRect
- Keyboard: Escape to close
- Click-outside to close
- Controlled & uncontrolled modes
- Sub-components: PopoverHeader, PopoverContent, PopoverFooter
- Rendered via createPortal

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

Prop	Type	Default	Description
`trigger`*	`React.ReactNode`	-	Element that opens the popover on click
`children`*	`React.ReactNode`	-	Popover content
`side`	`"top" \| "bottom" \| "left" \| "right"`	`"bottom"`	Preferred side to place the popover
`align`	`"start" \| "center" \| "end"`	`"start"`	Alignment relative to the trigger
`sideOffset`	`number`	`8`	Gap (px) between trigger and popover
`open`	`boolean`	-	Controlled open state
`onOpenChange`	`(open: boolean) => void`	-	Called when the open state changes

← Back to UI Components