Pitfalls and troubleshooting Symptom Likely cause Where to fix Components look unstyled Missing Tailwind @source for the library CSS setup White flash in dark mode No pre-load script; Root reads the dark class only Preventing flash Prose looks plain @tailwindcss/typography not installed Optional setup Code blocks have no colors No svelte-highlight theme imported Optional setup Manager getter throws Called outside a descendant of Root, or in a handler Mental models Modal resolves undefined Backdrop, Escape, or navigation dismissed it Overlays recipe Wrong page after filtering Page not reset or clamped Data Display recipe Items swap between unrelated lists Duplicate list IDs share a drag type Sortable Lists When the docs do not answer it Do not guess exports or props. Check the installed package's declarations and root exports, then the control's source and existing usages. For AI-assisted work start from the AI Consumer Entry Point.
Pitfalls and troubleshooting
@sourcefor the libraryRootreads thedarkclass only@tailwindcss/typographynot installedsvelte-highlighttheme importedRoot, or in a handlerundefinedWhen the docs do not answer it
Do not guess exports or props. Check the installed package's declarations and root exports, then the control's source and existing usages. For AI-assisted work start from the AI Consumer Entry Point.