Notifications & Feedback

Use-When

• Agent adds success/error/warning toasts
• Agent provides user feedback
• Agent creates notification systems
• Agent builds alert components

Core Rules

• ALWAYS use appropriate toast type (success, error, warning, info)
• ALWAYS allow dismissing notifications
• ALWAYS position toasts consistently (usually top-right or bottom-center)
• ALWAYS auto-dismiss non-critical toasts (3-5 seconds)
• NEVER stack more than 3 toasts at once
• NEVER use toasts for critical info requiring user action

Common Agent Mistakes

• Wrong toast type for message (error shown as success)
• Toasts that can't be dismissed
• Toasts that disappear too quickly or stay too long
• Stacking too many toasts
• Using toasts for critical alerts

Examples

✅ Correct

// Appropriate toast usage
<Toast variant="success" onDismiss={() => {}}>
  Changes saved successfully
</Toast>

<Toast variant="error" action={{ label: 'Retry', onClick: retry }}>
  Failed to save. Would you like to retry?
</Toast>

❌ Wrong

// Generic message
<Toast>Something happened</Toast>

// Can't dismiss
<div className="toast">
  Message
</div>

References

• Toast Notification UX