Skip to content
Mizen UI
Docs

IntroductionInstallationCLIStylingFoundationsThemingCompositionIntegrationsAccessibilityFor agents

useCopyToClipboard

AccordionAspect RatioCardCollapsibleFrameGridGroupInlineScroll AreaSectionSeparatorSpacerStack

BlockquoteCitationCodeHeadingKbdLabelLinkTextVisually Hidden

ButtonButton GroupToggleToggle groupToolbar

CalendarCheckboxCheckbox groupComboboxDate pickerDate range pickerDate-Time InputFieldFieldsetFile UploadFormInputInput groupNumber fieldOTP FieldRadio groupSelectSliderSwitchTextareaTime Input

BreadcrumbMenubarNavigation MenuPaginationSegmented ControlStepperTabs

Alert dialogCommandContext MenuDialogDrawerMenuPopoverPreview CardSheetTooltip

AlertBadgeEmptyError StateMeterProgressSkeletonSpinnerStatus dotToast

Activity FeedAvatarAvatar GroupData TableListMetricOverflow ListProperty ListTableTokenTree

Area ChartBar ListCalendar HeatmapCategory ComparisonChart FrameChart LegendChart TooltipDistributionFunnelHeatmapMetric TrendPart-to-WholeProgress RingsRadar ChartRadial BarsSankey ChartScatter ChartScore GaugeTime Series

Diagram

AttachmentCarouselCode BlockLightboxMarkdownThumbnailTimestamp

Agent ThinkingApproval CardComposerConversationInline CitationMessageMessage ScrollerQuestion CardSourcesStreaming TextSuggestionTask ListTerminalTool Call

On this page

  • Preview
  • Usage
  • Anatomy
  • Examples
  • Semantic variants
  • Interactive action
  • Iconless alert
  • Description-only alert
  • Recommendations
  • Usage boundaries
  • API reference

Feedback

Alert

Communicates important status messages with semantic variants, optional action slots, and accessible roles.

idle

Usage

import { Alert, AlertDescription, AlertIcon, AlertTitle } from "@mizen-labs/ui";

Anatomy

The parts and how they nest, taken from the preview above.

<Alert>
	<AlertIcon />
	<AlertTitle />
	<AlertDescription />
</Alert>

Examples

Semantic variants

Presents critical messages across five semantic tones with token-backed colors and contrast.

Interactive action

Interactive alerts should use role="region" with aria-labelledby to provide polite navigation landmarks.

Iconless alert

Renders without an icon slot; title and description align flush with container padding.

Description-only alert

Renders concise notification copy without a separate heading element.

Recommendations

GuidancePractice
Do

Explain the status and a useful next action. Choose announcement urgency to match the message.

Usage boundaries

GuidanceBoundary
Scope

Use Alert Dialog when a decision must interrupt the task. Do not announce routine updates as urgent alerts.

API reference

Public props from @mizen-labs/ui. Use exported prop types for the complete TypeScript contract.

PropTypeDefaultDescription
variant"default" | "error" | "info" | "success" | "warning""default"Selects the semantic visual variant and token palette.
roleAriaRole"alert"Sets the ARIA role; defaults to assertive alert for urgent dynamic text, overridable to status or region.
AlertAlertProps—Root compound container for the alert message, icon, and action slots.
AlertIconAlertIconProps—Slot for decorative status icon; defaults to aria-hidden.
AlertTitleAlertTitleProps—Slot for the primary alert heading or title.
AlertDescriptionAlertDescriptionProps—Slot for supporting alert description text.
AlertActionAlertActionProps—Layout slot for secondary action controls.
PreviousTooltipNextBadge
Maintenance scheduled
Routine infrastructure maintenance begins Sunday at 02:00 UTC.
Default alert
Standard operational feedback using surface and neutral content tokens.
Information note
Informational update with guidance on relevant system changes.
Deployment complete
All services were updated successfully without downtime.
Storage threshold
Database capacity has reached 85% utilization.
Connection failed
Unable to establish connection to the remote cluster.
Update available
A new software release is ready to install. Review changelog before proceeding.
Maintenance scheduled
Routine infrastructure maintenance begins Sunday at 02:00 UTC.
Your session will expire in five minutes due to inactivity.