dynauraTroubleshooting
The snags people hit most, and the one-line fix for each.
Nothing appears
Check that <Toaster /> is mounted once and that dynaura/styles.css is imported. Without the stylesheet the island renders unstyled.
The font is wrong, or I need to avoid Google Fonts
The stylesheet's first line is an @import for Bricolage Grotesque. Copy the stylesheet without it, or set --dynaura-font to your own font. This is also the fix for a strict Content Security Policy.
Can I have more than one Toaster?
No. State is a single global, so mount one Toaster per page.
Does it work with SSR?
Yes. The Toaster renders nothing on the server and mounts on the client. Calling dynaura.* on the server only sets state and shows nothing.
The toast sits under the notch or home indicator on iOS
Add viewport-fit=cover to your viewport meta tag. dynaura adds env(safe-area-inset-*) to the offset.
My description is a React component but it does not show in Vue or Svelte
React nodes only work in the React adapter. In Vue, Svelte and vanilla, pass a string or a DOM Node.
Still stuck? Open an issue on GitHub.