Communitygithub.com

CharbelElBateh/personal-website

Guía para Sonner, la librería de toasts para React: instala y configura el Toaster, elige la llamada toast() adecuada, toasts de promesa y carga, actualización, cierre y persistencia de toasts, estilos, temas e iconos, posicionamiento y múltiples toasters. Úsala al trabajar con Sonner o solucionar problemas como toasts que no aparecen, aparecen duplicados, pierden estilos, ignoran clases de Tailwind, se quedan detrás de un modal o no siguen el modo oscuro.

¿Qué es personal-website?

Esta habilidad proporciona una guía completa sobre Sonner, una librería de toasts para React. Es útil para desarrolladores que necesitan instalar, configurar, estilizar y solucionar problemas de Sonner al construir interfaces de usuario con notificaciones temporales (toasts). Soporta cualquier plataforma que use React, como Next.js, Remix, Astro o aplicaciones vanilla con React. La habilidad funciona proporcionando instrucciones detalladas, tablas de referencia y una estrategia de escalado de estilos (de los valores predeterminados a headless) para manejar desde configuraciones básicas hasta casos complejos. Cubre la configuración inicial (el componente `<Toaster />` montado una vez y la función `toast()` en el lado del cliente), la elección del tipo de toast correcto según la necesidad (mensaje simple, éxito, error, carga, promesa, JSX personalizado), recetas para actualizar, persistir y cerrar toasts, y una sección de solución de problemas que aborda síntomas comunes como toasts que no aparecen, aparecen duplicados, ignoran estilos de Tailwind o no respetan el modo oscuro. También incluye referencias a documentación adicional en `API.md` para detalles de propiedades.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Trabajando con Sonner

Respuesta Inicial

Cuando esta habilidad se invoque por primera vez sin una pregunta específica, responde únicamente con:

Estoy listo para ayudarte a configurar, estilizar y solucionar problemas de Sonner. Mi conocimiento proviene de su autor, Emil Kowalski.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Una guía de habilidad para Sonner, la librería de toasts. Cuando una tarea involucre a Sonner (configurarlo, renderizar toasts, estilizarlos o repararlos), responde primero desde este archivo. Las tablas de propiedades completas para <Toaster /> y toast() se encuentran en API.md; léelo cuando necesites un nombre de propiedad, tipo o valor por defecto exacto.

Configuración

Dos piezas, y solo dos:

  1. Un <Toaster />, montado una vez, lo más cerca de la raíz posible (en Next.js: layout.tsx — funciona dentro de componentes servidor). Nunca lo renderices por página o condicionalmente; un segundo Toaster montado duplica cada toast.
  2. toast() llamado desde código cliente — manejadores de eventos, efectos, callbacks. Es una función simple, no necesita hook ni proveedor, pero no hace nada en el servidor: en una acción de servidor, devuelve el resultado y llama a toast() en el código cliente que lo recibe.
import { Toaster } from 'sonner'; // una vez, en el layout
import { toast } from 'sonner';   // en cualquier lugar del lado cliente

Eligiendo la llamada correcta

QuieresLlamada
Mensaje simpletoast('Título') — añade { description } para una segunda línea
Icono de éxito / error / info / advertenciatoast.success('…'), toast.error('…'), etc.
Spinner mientras gestionas el estado tú mismotoast.loading('…'), luego actualízalo por id
Carga → éxito/error vinculado a una promesatoast.promise(promise, { loading, success, error }) — success/error aceptan funciones que reciben el valor resuelto/error
Botón que hace algo{ action: { label, onClick } } — cierra el toast a menos que onClick llame a event.preventDefault(); cancel es la variante secundaria
JSX personalizado, shell de toast por defectotoast(<jsx />)
JSX personalizado, sin estilostoast.custom((t) => <jsx />) — headless, t te da el id para descartar

Recetas

Actualizar un toast — llama a toast() de nuevo con el mismo id; solo cambian las props que pasas. Cambiar a toast.success(…, { id }) cambia el tipo. Así es como funcionan los flujos de carga → éxito sin toast.promise:

const id = toast.loading('Subiendo…');
toast.success('Subido', { id });

Persistir — { duration: Infinity }. Descartar — toast.dismiss(id), o toast.dismiss() para todos. Leer toasts activos — useSonner() en React, toast.getActiveToasts() fuera de él.

Enlaces o componentes en el texto — pasa una función para el título o la descripción: toast(() => <a href="…">Ver</a>).

Múltiples toasters — dale a cada uno un id y apunta con toast('…', { toasterId: 'canvas' }). Sin toasterId, cada toaster renderiza el toast.

Callbacks de cierre — onDismiss se dispara al hacer clic en el botón de cerrar o al deslizar; onAutoClose se dispara por tiempo de espera. Son independientes; no hay un único callback "cerrado".

Estilos — la escalera de escalado

Solo sube hasta donde el cambio lo requiera; saltar al peldaño superior demasiado pronto está bien (es el estado final recomendado), pero quedarse en el medio no lo está.

  1. Valores predeterminados — además de richColors en el Toaster para éxito/error coloridos, invert para invertir contra el tema.
  2. Ajustes inline — toastOptions={{ style: {…} }} en el Toaster para todos los toasts, o style por llamada a toast().
  3. Clases en partes — toastOptions={{ classNames: { toast, title, description, actionButton, cancelButton, closeButton } }}. Los estilos inyectados de Sonner ganan en la cascada, por lo que cada clase necesita !important (Tailwind: !text-red-900). Si estás marcando más de unas pocas cosas como importantes, detente — pasa a headless.
  4. Headless — toast.custom() con tu propio JSX, manteniendo el posicionamiento, apilamiento y deslizamiento de Sonner. El enfoque recomendado para un toast de sistema de diseño: envuélvelo en tu propia abstracción toast(). (unstyled: true existe como término medio, pero headless da más control por el mismo esfuerzo.)

Iconos — intercambia los predeterminados por tipo con la prop icons del Toaster, por toast con icon, elimínalos con null.

Tema — theme predeterminado es 'light' y no sigue al SO. Pasa theme="system", o conecta tu proveedor de temas: <Toaster theme={resolvedTheme} /> desde next-themes.

Solución de problemas

SíntomaCausa → solución
El toast nunca apareceNo hay <Toaster /> montado, o se desmontó (renderizado condicional, colocación por página). Monta uno en la raíz. Si se llama desde una acción de servidor: toast() es solo para cliente — llámalo con el resultado de la acción en el cliente.
El mismo toast aparece dos vecesDos Toasters montados (layout y página) — manten uno. O toast() se disparó en un efecto bajo la doble invocación de desarrollo de React StrictMode — dispáralo desde el manejador de eventos en su lugar, o pasa un id estable para que la segunda llamada actualice en lugar de duplicar.
Las clases de Tailwind/CSS no tienen efectoLos estilos predeterminados los anulan. Márcalos con !important, o usa unstyled / headless (ver la escalera arriba).
Los toasts se renderizan completamente sin estilos (común en Astro, transiciones de vista)La hoja de estilos inyectada de Sonner se perdió — impórtala explícitamente en un layout: import 'sonner/dist/styles.css'.
Sin estilos dentro de Shadow DOMLos estilos caen en document.head, no en la raíz shadow. Copia la etiqueta style cuyo texto incluye [data-sonner-toaster] dentro de la raíz shadow.
Toast detrás de un modal/overlay, o recortadoUn ancestro crea un contexto de apilamiento (transform, filter, overflow) o el overlay supera en z-index al toaster. Mueve <Toaster /> a la raíz del documento, fuera de cualquier contenedor de diálogo/portal.
Modo oscuro ignoradotheme predeterminado es 'light' — establece theme="system" o pasa el tema resuelto (ver Tema arriba).
Éxito/error se ven grises, no verde/rojoEso es lo predeterminado. Añade richColors al Toaster.
El toast nunca se cierraduration: Infinity, dismissible: false, o una toast.promise cuya promesa nunca se resuelve — el toast de carga espera para siempre.
toast.promise se queda en cargaNecesita una promesa (o una función que devuelva una) como primer argumento, y la promesa debe resolverse/rechazarse realmente.
Deslizar para descartar va en la dirección equivocada / no funcionaLas direcciones derivan de position. Anula con swipeDirections en el Toaster.
El toast aparece en todos los toastersLos múltiples toasters necesitan direccionamiento: dale a cada Toaster un id y pasa toasterId en la llamada a toast().
Toasts demasiado cerca del borde de la pantalla en móvilesoffset (escritorio, 32px predeterminado) y mobileOffset (<600px, 16px predeterminado) — números, strings CSS u objetos por lado.

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.

Skills relacionados