Troubleshooting
How to troubleshoot common issues with Animate UI.
Verify your versions
| Dependency | Minimum recommended version |
|---|---|
| Motion | ≥ 12.23.0 |
| React | ≥ 19 |
| Tailwind CSS | ≥ 4.1.0 |
| Base UI | 1.0.0-beta.3 |
| Radix UI | ≥ 1.4.0 |
| Headless UI | ≥ 2.2.0 |
Make sure your environment meets or exceeds these versions to ensure Animate UI remains compatible and stable.
Documentation display issues
Certain browser extensions can interfere with how the documentation is rendered. Common culprits include:
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 that you configured in the aliases in the components.json file. This is because we can't use a target path with aliases.
We have filed an issue on shadcn/ui, Shadcn added it to the roadmap.
For now, we recommend using the manual installation.
Other issues
If you encounter any other problem, don't hesitate to open an issue here.