Alert

Your changes are saved.

You can continue editing this workspace.

Review your connection.

This static example uses a note. Reserve role="alert" for urgent updates.

Usage

import { Alert } from "@devvy-ui/react";

<Alert tone="brand">
  <strong>Changes saved.</strong>
  <p>Your workspace is up to date.</p>
</Alert>

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
tone	neutral \| brand \| danger	neutral	Border and decorative icon tone. Message text carries meaning.
variant	soft \| outline	soft	Surface treatment.
role	native ARIA role	status	Polite updates by default; use alert for urgent changes or note for static guidance.
icon	ReactNode	information icon	Decorative only. Keep essential information in the message.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add alert

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Alert.tsxREACT / TSX

import { forwardRef, type HTMLAttributes, type ReactNode } from 'react';
import { cx } from '../lib/cx';

export interface AlertProps extends HTMLAttributes<HTMLDivElement> {
  tone?: 'neutral' | 'brand' | 'danger';
  variant?: 'soft' | 'outline';
  /** Decorative icon; put essential information in the message. */
  icon?: ReactNode;
}

export const Alert = forwardRef<HTMLDivElement, AlertProps>(function Alert(
  { className, tone = 'neutral', variant = 'soft', role = 'status', icon, children, ...props },
  ref,
) {
  return (
    <div
      {...props}
      ref={ref}
      role={role}
      className={cx('dvy-alert', 'dvy-glass-surface', className)}
      data-tone={tone}
      data-variant={variant}
    >
      <span className="dvy-alert-icon" aria-hidden="true">
        {icon ?? (
          <svg viewBox="0 0 20 20" fill="none" stroke="currentColor" focusable="false">
            <circle cx="10" cy="10" r="8" />
            <path d="M10 9v5m0-9v2" strokeWidth="1.5" />
          </svg>
        )}
      </span>
      <div className="dvy-alert-content">{children}</div>
    </div>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.