Troubleshooting

Check the installed version

1npm ls @qentrah/dui

Compare the installed version with the version noted in this guide. Inspect your lockfile before changing dependencies; prerelease behavior may differ between versions.

Import or module errors

Use only public import paths listed in API and exports. Avoid importing guessed paths inside dist. ESM-only packages require an ESM-aware application. Install declared peer dependencies in the consuming application.

Missing styles or wrong import aliases

Check components.json, Tailwind configuration and the generated source path. The CLI adds source files, so importing a component from @qentrah/dui is not the component-consumption path. Use your local component alias. Review dry-run output before replacing modified files.