Common Errors
Quick reference for frequent io.Connect development errors and their fixes.
| Error | Cause | Fix |
|---|---|---|
Module not exported | Interface not exported from module | Add export keyword, restart dev server |
| White screen / Blank iframe | Wrong port or initialization hung | Check ports, open iframe URL directly in new tab |
| CSS not updating | Browser cache | Hard refresh (Ctrl+Shift+R), restart dev servers |
does not provide an export named X | Importing from parent directory in Vite | Copy shared files into each app's src/ |
useIOConnectContext is not exported | Wrong hook name | Use useContext(IOConnectContext) |
type must be imported using type-only import | verbatimModuleSyntax enabled | Use import type { X } for types |
Method already registered | Missing cleanup in useEffect | Return io.interop.unregister() in effect cleanup |
| Double initialization | React.StrictMode wrapping IOConnectProvider | Remove StrictMode wrapper |
Still stuck?Check the Developer Community or the FAQ for more help.