Toast

Usage

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

<Toast open={saved} onOpenChange={setSaved} message="Project saved." />

API reference

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

Prop	Type	Default	Description
open	boolean	required	Whether the notification is visible.
message	string	required	Live status/alert text.
onOpenChange	(open: boolean) => void	required	Dismissal callback.
duration	number	5000	Dismissal delay; 0 disables timing.
tone	neutral / danger	neutral	Status or urgent alert semantics.

Source ownership

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

npx @devvy-ui/cli add toast

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.

Toast.tsxREACT / TSX

import { forwardRef, useEffect, useState, type HTMLAttributes } from 'react';
export interface ToastProps extends HTMLAttributes<HTMLDivElement> {
  open: boolean;
  onOpenChange: (open: boolean) => void;
  message: string;
  duration?: number;
  tone?: 'neutral' | 'danger';
}
export const Toast = forwardRef<HTMLDivElement, ToastProps>(function Toast(
  { open, onOpenChange, message, duration = 5000, tone = 'neutral', children, className, ...props },
  ref,
) {
  const [paused, setPaused] = useState(false);
  useEffect(() => {
    if (!open || paused || duration <= 0 || document.hidden) return;
    const timeout = setTimeout(() => onOpenChange(false), duration);
    return () => clearTimeout(timeout);
  }, [open, paused, duration, onOpenChange, message]);
  useEffect(() => {
    const change = () => setPaused(document.hidden);
    document.addEventListener('visibilitychange', change);
    return () => document.removeEventListener('visibilitychange', change);
  }, []);
  return (
    <div
      {...props}
      ref={ref}
      className={['dvy-toast', className].filter(Boolean).join(' ')}
      hidden={!open}
      data-tone={tone}
      onMouseEnter={(event) => {
        props.onMouseEnter?.(event);
        setPaused(true);
      }}
      onMouseLeave={(event) => {
        props.onMouseLeave?.(event);
        setPaused(false);
      }}
      onFocus={(event) => {
        props.onFocus?.(event);
        setPaused(true);
      }}
      onBlur={(event) => {
        props.onBlur?.(event);
        if (!event.currentTarget.contains(event.relatedTarget as Node)) setPaused(false);
      }}
    >
      <div role={tone === 'danger' ? 'alert' : 'status'}>{open ? message : ''}</div>
      {children}
      <button type="button" aria-label="Dismiss notification" onClick={() => onOpenChange(false)}>
        ×
      </button>
    </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.