UI Components

Toast

Global notification system with auto-dismiss, four variants, six positions, and useToast hook

Quick Preview

Installation

// Copy the Toast component from
src/components/ui/Toast.tsx

Usage

// 1. Wrap your app (or layout) with ToastProvider
import { ToastProvider } from '@/components/ui/Toast'

export default function Layout({ children }) {
  return (
    <ToastProvider position="top-right">
      {children}
    </ToastProvider>
  )
}

// 2. Use the hook anywhere inside the provider
'use client'
import { useToast } from '@/components/ui/Toast'

export default function SaveButton() {
  const { addToast } = useToast()

  async function handleSave() {
    await save()
    addToast('Changes saved!', { variant: 'success', duration: 3000 })
  }

  return <button onClick={handleSave}>Save</button>
}

Examples

Positions

Set position on ToastProvider to control where toasts appear. Options: top-right, top-left, top-center, bottom-right, bottom-left, bottom-center.

Custom Duration

Default duration is 4000 ms. Pass a custom duration (ms) in options.

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a ui component named Toast in React/Next.js.
Goal: recreate the same overall UI and behavior as the Toast reference from a component gallery.
What it needs to communicate: Global notification system with auto-dismiss, four variants, six positions, and useToast hook.

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- message: string — required — Notification message text
- variant: "success" | "error" | "warning" | "info" — default "info" — Visual variant
- duration: number — default 4000 — Auto-dismiss delay in milliseconds
- position: ToastPosition — default "top-right" — Stack position on screen (ToastProvider prop)

Reference usage patterns:
- Basic

```tsx
const { addToast } = useToast()
addToast('Saved!', { variant: 'success' })
```

- Provider Setup

```tsx
<ToastProvider position="top-right">
  <App />
</ToastProvider>
```

Feature expectations:
- Context + useToast hook API
- ToastProvider wraps app (or section)
- Four variants: success, error, warning, info
- Six stack positions
- Auto-dismiss with configurable duration
- Manual dismiss button
- Portal rendering
- role="alert" + aria-live
- Client Component

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`message`*	`string`	-	Notification message text
`variant`	`"success" \| "error" \| "warning" \| "info"`	`"info"`	Visual variant
`duration`	`number`	`4000`	Auto-dismiss delay in milliseconds
`position`	`ToastPosition`	`"top-right"`	Stack position on screen (ToastProvider prop)

Features

✓Context + useToast hook API
✓ToastProvider wraps app (or section)
✓Four variants: success, error, warning, info
✓Six stack positions
✓Auto-dismiss with configurable duration
✓Manual dismiss button
✓Portal rendering
✓role="alert" + aria-live
✓Client Component