---
name: toast-usage
description: >
Use after component-usage-ux when an app needs @techsio/ui-kit Toast for
transient CRUD feedback using the global Zag.js toaster store, Toaster
portal, useToast, toast types, title, description, close trigger, and token
styling.
metadata:
component_version: "1.2.1"
type: "core"
library: "@techsio/ui-kit"
library_version: "0.3.2"
requires: "component-usage-ux app-token-overrides ux-guidelines"
resources: "references/ux.md ../../references/component-contracts.md ../../references/consumer_app_usage_rules.md"
sources: "https://zagjs.com/components/react/toast"
contributor_sources: "libs/ui/src/molecules/toast.tsx libs/ui/src/tokens/components/molecules/_toast.css libs/ui/stories/molecules/toast.stories.tsx libs/ui/src/molecules/toast.figma.ts"
audience: "consumer"
---
> Portable scope: Use the installed package's exported types and bundled sibling skills. Repository source paths are optional contributor evidence, not consumer prerequisites; use the consuming app's own checks. Resolve ../../references/ paths from this skill's folder, not the app working directory.
# @techsio/ui-kit Toast Usage
Use Toast for transient feedback after actions. Use StatusText for inline field
messages and Dialog for blocking decisions.
## UX/UI guidelines
House rules come from the `ux-guidelines` skill (writing, formatting, states,
where actions and feedback live). This section applies them to `Toast`.
**Use it when**
- Confirming a finished mutation when the UI doesn't show it clearly (drawer closed, row updated, background save).
- Results of async/background work; `Undo` for reversible destructive actions.
**Use something else when**
| Need | Use instead |
| --- | --- |
| Field or form validation | inline errors + FormErrorSummary |
| Irreversible decisions | Dialog role="alertdialog" |
| Persistent page conditions | inline StatusText at the top of the content |
| Information to read or copy later | inline content |
**Do**
- Mount one `` in the app root; keep the kit placement bottom-end (bottom-right) — ux-guidelines/feedback-and-actions#toasts.
- Title `