Troubleshooting

Verify your versions

Make sure your environment meets or exceeds these versions to ensure Unlumen UI remains compatible and stable.

Documentation display issues

Certain browser extensions can interfere with how the documentation is rendered. Common culprits include:

• Screen Shader | Smart Screen Tinting

If problems persist after disabling extensions, clear your browser cache and refresh the page.

The CLI installation does not respect aliases

In some projects, components may not install in the desired location configured via the aliases in your components.json file. This is a known limitation of the shadcn CLI — it cannot use a target path with aliases.

An issue has been filed on shadcn/ui and it is on their roadmap.

For now, we recommend using the manual installation method.

Other issues

If you encounter any other problem, don't hesitate to open an issue here.