Base UI Overlay and Popup Patterns

Use this skill for popup components and cross-cutting overlay conventions.

Covered family

• Alert Dialog, Context Menu, Dialog, Drawer, Menu, Menubar, Navigation Menu, Popover, Preview Card, Toast, Toolbar, Tooltip

Routing cues

• "portal", "overlay", "positioning", "focus return", "escape", "open change", "detached trigger", "stacked popup" → this skill

Canonical references

• https://base-ui.com/react/components/alert-dialog
• https://base-ui.com/react/components/dialog
• https://base-ui.com/react/components/popover
• https://base-ui.com/react/components/menu
• https://base-ui.com/react/components/tooltip

Maintenance

• Snapshot date: 2026-02-13
• Refresh cadence: quarterly
• Upstream changelog anchor: https://github.com/mui/base-ui/blob/master/CHANGELOG.md

References

• Overlay anatomy and state patterns
• Portal/lifecycle and lifecycle state