diff --git a/frontends/nextjs/src/components/ui/sonner.tsx b/frontends/nextjs/src/components/ui/sonner.tsx
index b70734cdf..9ee4c8d07 100644
--- a/frontends/nextjs/src/components/ui/sonner.tsx
+++ b/frontends/nextjs/src/components/ui/sonner.tsx
@@ -2,7 +2,24 @@
 
 /**
  * Sonner-compatible toast API using MUI Snackbar
- * Provides a drop-in replacement for the 'sonner' package
+ * Provides a drop-in replacement for the 'sonner' package.
+ *
+ * Usage:
+ *
+ * ```tsx
+ * import { Toaster, toast } from '@/components/ui/sonner'
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <button onClick={() => toast('Default message')}>Show default toast</button>
+ *       <button onClick={() => toast.success('Saved!')}>Show success toast</button>
+ *       <button onClick={() => toast.error('Failed to save')}>Show error toast</button>
+ *       <Toaster />
+ *     </>
+ *   )
+ * }
+ * ```
  */
 
 import React, { createContext, useCallback, useContext, useEffect, useState } from 'react'