Troubleshooting

Common issues and their solutions.

Routes Not Matching

Problem: Routes don’t match even though the URL looks correct.

Solution: Check route pattern syntax:

• Use :param for named parameters
• Use /*param for wildcards
• Ensure <Switch> wraps routes correctly

Nested Routes Not Working

Problem: Child routes don’t match in nested structures.

Solution: Ensure nest prop is set:

SSR Issues

Problem: Routes don’t work on server.

Solution: Always wrap with <Router> and pass ssrPath:

Data Not Reactive

Problem: Route data doesn’t update when parent changes.

Solution: Ensure you’re using ref() or computed():

Query Parameters Not Working

Problem: Query parameters are empty on client-side hydration.

Solution: This is fixed in latest version. Ensure you’re using useSearchParams() correctly:

Need Help?

• Check API Reference
• See Examples
• Open an issue on GitHub