How to troubleshoot common issues with Odyssey UI.
Verify your versions
| Dependency | Minimum recommended version |
|---|---|
| React | ≥ 19 |
| Tailwind CSS | ≥ 4.1.0 |
| Motion | ≥ 12.23.0 |
| GSAP | 3.14.2 |
| Base UI | 1.0.0-beta.3 |
Make sure your environment meets or exceeds these versions to ensure Odyssey UI remains compatible and stable—no one likes a shipwreck before setting sail.
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. When in doubt, turn it off and on again—the IT crowd knew what they were talking about.
Other issues
If you encounter any other problem, don't hesitate to open an issue here. We're all ears—and fingers on keyboards.