Instruction file imported from pubky/pubky-app (.cursor/rules/toast.mdc). Copyright stays with the author.

Toast Rules

@docs/components.md — Toasts

Variants

Use variant on toast() — never className: 'destructive …' or showErrorToast / showSuccessToast helpers.

API

import { toast } from '@/molecules/Toaster/toast';

toast({ variant: 'error', description: '...' });
toast({ title: 'Saved', description: '...' }); // default
toast({ title: 'Reposted', action: { label: 'Undo', altText: 'Undo', onClick: () => {} } });

toast() is the only public producer API; toast.store.ts, useToastState.ts, and the @/atoms/Toast/* renderer atoms are Toaster-internal (ESLint-enforced). Custom actions are descriptors ({ label, altText, onClick }), never components — the Toaster renders and styles them. Styling: Toast.variants.ts only.