Troubleshooting

#Styles Are Missing

Confirm both CSS files are imported and that the theme import comes first.

import "@froggdesign/theme/styles.css";
import "@froggdesign/enter-ui-react/styles.css";

#Dark Mode Does Not Apply

Set data-theme="dark" on a root element that contains the application. EnterUI reads CSS variables from the active theme scope.

<html lang="en" data-theme="dark">
  <body>{children}</body>
</html>

#Dialog Or Menu Content Does Not Appear In SSR Markup

Portal-based content is browser-rendered. Test trigger semantics in SSR and open content in jsdom or browser tests.

#Trigger Loses Keyboard Behavior

When using asChild, pass a semantic focusable element:

<DialogTrigger asChild>
  <button type="button">Open</button>
</DialogTrigger>

#Form Error Is Not Announced

Use FormField with a single child control, or manually connect the control to the error with aria-describedby and aria-invalid.

#Duplicate React Versions

If hooks or context fail unexpectedly, check that the app resolves one React and React DOM version compatible with the package peer dependency range.