Communitygithub.com

Arbeit mit Sonner

Eine Anleitung zur React-Toast-Bibliothek Sonner – Installation, Einbindung des Toasters, die richtige `toast()`-Methode, Promise- und Lade-Toasts, Aktualisierung, Schließen und Beibehalten von Toasts, Styling, Theming und Symbole, Positionierung und mehrere Toaster. Verwenden Sie diese bei der Arbeit mit Sonner oder zur Fehlerbehebung – Toasts, die nicht erscheinen, doppelt erscheinen, ihr Styling verlieren, Tailwind-Klassen ignorieren, hinter einem Modal hängen oder den Dark Mode nicht beachten.

Was ist Arbeit mit Sonner?

Dieses Skill bietet eine umfassende Anleitung für Sonner, eine leistungsstarke und anpassbare React-Toast-Bibliothek. Es deckt den gesamten Lebenszyklus von Toasts ab: von der initialen Einrichtung – mit genau einem `<Toaster />` an der Wurzel der Anwendung – über die verschiedenen Aufrufvarianten (`toast()`, `toast.success()`, `toast.loading()`, `toast.promise()`) bis hin zu fortgeschrittenen Techniken wie dem Aktualisieren, Schließen und Beibehalten von Toasts. Der besondere Fokus liegt auf einer abgestuften Styling-Strategie, die von Standardeinstellungen über Tailwind-Klassen bis hin zu einem vollständig Headless-Modus mit `toast.custom()` reicht. Das Skill hilft Entwicklern, häufige Probleme zu diagnostizieren und zu beheben, wie z. B. Toasts, die nicht erscheinen (fehlender Toaster oder serverseitiger Aufruf), doppelt erscheinen (zweiter Toaster oder React StrictMode) oder ihr Styling verlieren (verlorenes CSS, Shadow DOM, Stacking-Kontext). Es unterstützt Plattformen wie Next.js, Astro und alle React-basierten Frameworks und ist der ideale Begleiter für jeden Entwickler, der eine zuverlässige, individuelle Toast-Benachrichtigung in seine Anwendung integrieren möchte.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/ask-sonner

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Arbeiten mit Sonner

Erstantwort

Wenn dieses Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, Ihnen bei der Einrichtung, dem Styling und der Fehlerbehebung von Sonner zu helfen. Mein Wissen stammt vom Autor Emil Kowalski.

Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.

Ein Anleitungs-Skill für Sonner, die Toast-Bibliothek. Wenn eine Aufgabe Sonner betrifft – Einrichtung, Anzeige von Toasts, Styling oder Fehlerbehebung – antworte zuerst aus dieser Datei. Vollständige Prop-Tabellen für <Toaster /> und toast() befinden sich in API.md; lies sie, wenn du einen genauen Prop-Namen, -Typ oder -Standardwert benötigst.

Einrichtung

Zwei Teile, und nur zwei:

  1. Ein <Toaster />, einmal eingebunden, so nah wie möglich an der Wurzel (in Next.js: layout.tsx – es funktioniert innerhalb von Server-Komponenten). Binde es niemals pro-Seite oder bedingt ein; ein zweiter eingebundener Toaster dupliziert jeden Toast.
  2. toast() aus Client-Code aufgerufen – Event-Handler, Effekte, Callbacks. Es ist eine einfache Funktion, kein Hook oder Provider erforderlich, aber sie tut nichts auf dem Server: Gib in einer Server-Action das Ergebnis zurück und rufe toast() im Client-Code auf, der es empfängt.
import { Toaster } from 'sonner'; // einmal, im Layout
import { toast } from 'sonner';   // überall client-seitig

Die richtige Methode auswählen

GewünschtAufruf
Einfache Nachrichttoast('Titel') – füge { description } für eine zweite Zeile hinzu
Erfolgs-/Fehler-/Info-/Warnungssymboltoast.success('…'), toast.error('…'), usw.
Ladeanzeige, während du den Status selbst verwaltesttoast.loading('…'), aktualisiere dann per ID
Laden → Erfolg/Fehler, verknüpft mit einem Promisetoast.promise(promise, { loading, success, error }) – success/error akzeptieren Funktionen, die den aufgelösten Wert/Fehler erhalten
Schaltfläche, die etwas tut{ action: { label, onClick } } – schließt den Toast, es sei denn, onClick ruft event.preventDefault() auf; cancel ist die sekundäre Variante
Benutzerdefiniertes JSX, standardmäßiger Toast-Rahmentoast(<jsx />)
Benutzerdefiniertes JSX, überhaupt keine Stiletoast.custom((t) => <jsx />) – Headless, t gibt dir die ID zum Schließen

Rezepte

Einen Toast aktualisieren – rufe toast() erneut mit derselben id auf; nur die Props, die du übergibst, ändern sich. Der Wechsel zu toast.success(…, { id }) ändert den Typ. So funktionieren Lade-zu-Erfolg-Abläufe ohne toast.promise:

const id = toast.loading('Wird hochgeladen…');
toast.success('Hochgeladen', { id });

Beibehalten – { duration: Infinity }. Schließen – toast.dismiss(id) oder toast.dismiss() für alle. Aktive Toasts lesen – useSonner() in React, toast.getActiveToasts() außerhalb.

Links oder Komponenten im Text – übergib eine Funktion für den Titel oder die Beschreibung: toast(() => <a href="…">Ansehen</a>).

Mehrere Toaster – gib jedem eine id und ziele mit toast('…', { toasterId: 'canvas' }). Ohne toasterId rendert jeder Toaster den Toast.

Schließen-Callbacks – onDismiss feuert bei Schließen-Button oder Wischen; onAutoClose feuert bei Timeout. Sie sind getrennt; es gibt keinen einzelnen „geschlossen"-Callback.

Styling – die Eskalationsleiter

Steige nur so weit hinauf, wie es die Änderung erfordert; zu früh zur obersten Sprosse zu springen ist in Ordnung (es ist der empfohlene Endzustand), in der Mitte zu verweilen nicht.

  1. Standardwerte – plus richColors am Toaster für bunte Erfolgs-/Fehleranzeigen, invert zum Umdrehen gegen das Theme.
  2. Inline-Anpassungen – toastOptions={{ style: {…} }} am Toaster für alle Toasts oder style pro toast()-Aufruf.
  3. Klassen an Teilen – toastOptions={{ classNames: { toast, title, description, actionButton, cancelButton, closeButton } }}. Sonners eingefügte Stile gewinnen die Kaskade, daher benötigt jede Klasse !important (Tailwind: !text-red-900). Wenn du mehr als ein paar Dinge als important markierst, hör auf – gehe Headless.
  4. Headless – toast.custom() mit eigenem JSX, wobei Sonners Positionierung, Stapelung und Wischfunktion erhalten bleiben. Der empfohlene Ansatz für einen Design-System-Toast: Kapsle ihn in deiner eigenen toast()-Abstraktion. (unstyled: true existiert als Zwischenlösung, aber Headless gibt bei gleichem Aufwand mehr Kontrolle.)

Symbole – tausche Standard-Symbole pro Typ mit der icons-Prop am Toaster aus, pro Toast mit icon, entferne sie mit null.

Theme – theme standardmäßig 'light' und verfolgt nicht das Betriebssystem. Übergib theme="system" oder kopple deinen Theme-Provider: <Toaster theme={resolvedTheme} /> von next-themes.

Fehlerbehebung

SymptomUrsache → Lösung
Toast erscheint nieKein <Toaster /> eingebunden, oder er wurde ausgehängt (bedingtes Rendern, platzierung pro Seite). Binde einen an der Wurzel ein. Bei Aufruf aus einer Server-Action: toast() ist nur clientseitig – rufe es mit dem Ergebnis der Action auf dem Client auf.
Gleicher Toast erscheint doppeltZwei Toaster eingebunden (Layout und Seite) – behalte einen. Oder toast() in einem Effekt unter React StrictModes doppeltem Aufruf im Entwicklungsmodus – rufe stattdessen im Event-Handler auf oder übergib eine stabile id, sodass der zweite Aufruf aktualisiert statt dupliziert.
Tailwind/CSS-Klassen haben keine WirkungStandard-Stile überschreiben sie. Markiere sie mit !important oder verwende unstyled / Headless (siehe Leiter oben).
Toasts werden völlig ohne Styling gerendert (häufig in Astro, View Transitions)Sonners eingefügtes Stylesheet ging verloren – importiere es explizit in einem Layout: import 'sonner/dist/styles.css'.
Ohne Styling im Shadow DOMStile landen in document.head, nicht im Shadow Root. Kopiere das Style-Tag, dessen Text [data-sonner-toaster] enthält, in den Shadow Root.
Toast hinter einem Modal/Overlay oder abgeschnittenEin Vorfahre erzeugt einen Stacking-Kontext (transform, filter, overflow) oder das Overlay hat einen höheren z-Index als der Toaster. Verschiebe <Toaster /> an die Dokument-Wurzel, außerhalb jedes Dialog-/Portal-Containers.
Dark Mode ignorierttheme standardmäßig 'light' – setze theme="system" oder übergib das aufgelöste Theme (siehe Theme oben).
Erfolg/Fehler sehen grau aus, nicht grün/rotDas ist der Standard. Füge richColors zum Toaster hinzu.
Toast schließt nieduration: Infinity, dismissible: false oder ein toast.promise, dessen Promise nie erfüllt wird – der Lade-Toast wartet ewig.
toast.promise bleibt beim Laden hängenEs benötigt ein Promise (oder eine Funktion, die eines zurückgibt) als erstes Argument, und das Promise muss tatsächlich erfüllt/abgelehnt werden.
Wisch-zum-Schließen geht in die falsche Richtung / funktioniert nichtDie Richtungen leiten sich von position ab. Überschreibe sie mit swipeDirections am Toaster.
Toast erscheint in jedem ToasterMehrere Toaster müssen anvisiert werden: Gib jedem Toaster eine id und übergib toasterId im toast()-Aufruf.
Toasts auf mobilen Geräten zu nah am Bildschirmrandoffset (Desktop, Standard 32px) und mobileOffset (<600px, Standard 16px) – Zahlen, CSS-Strings oder objekte pro Seite.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Verwandte Skills