Docs

Molecules

Toast

Succinct notification feedback banner with timer dismiss.

5 examplesData ComponentReact 19 & Next.js 16Tailwind CSS v4
Install
pnpm add @quinkit/ui sonner
Import
import { Toast } from "@quinkit/ui";

Required packages

Powers Toast / Toaster. Add these packages before using this component:

  • @quinkit/ui
  • sonner

Install command is shown above. Without the peer package, imports will fail at build time.

Interactive Examples

Live previews · code · themes · viewport · dark mode

Default Toast

A simple toast with title and description.

Default Toast rendered preview

Success, Error & Status Variants

Status variants and promise-driven toasts.

Success, Error & Status Variants rendered preview

With Action Button

Attach an actionable button such as Undo.

With Action Button rendered preview

Toast Positions

Render toasts in any screen corner.

Toast Positions rendered preview

Form-Submission Feedback

Realistic form save notification with success status.

Form-Submission Feedback rendered preview

Overview

Toast is part of the Week 4–6 free core component set. It follows the shared component standard with TypeScript exports, semantic token styling, accessibility-minded markup, and Storybook examples.

Installation

bash
pnpm add @quinkit/ui sonner

sonner is a required peer dependency for Toast / Toaster.

Accessibility Details

  • Uses semantic HTML or Radix primitives where applicable.
  • Interactive components expose keyboard/focus behavior through native controls or Radix.
  • ARIA roles, states, and labels are applied where relevant.

Styling

  • Uses semantic design tokens such as bg-background, text-foreground, border-border, bg-popover, and text-muted-foreground.
  • Motion-heavy components include reduced-motion compatible classes where applicable.

Accessibility & Keyboard

Toast adheres to WAI-ARIA design patterns for accessible web components.

Keyboard Navigation

  • Tab / Shift + Tab — Focuses control and moves between interactive elements.
  • Space / Enter — Triggers action or toggles selection.
  • Escape — Closes open popovers, overlays, or dropdown menus.

ARIA Standards

  • Built with semantic HTML tags and explicit aria-* attributes.
  • Uses high-contrast focus rings (ring-ring) visible in both light & dark mode.
  • Supports screen readers with non-visual label fallbacks.

Registry Install

Add a shadcn-compatible bridge file to your project that re-exports from @quinkit/ui.

Registry
npx shadcn@latest add https://quinkit-ui.vercel.app/r/toast.json