Troubleshooting
Common issues and solutions when working with React ECharts Kit.
Installation Issues
Module not found: Can't resolve 'echarts'
This error occurs when ECharts is not properly installed.
Solution:
bash
TypeScript errors with chart components
TypeScript may not recognize the chart component types.
Solution:
bash
Server-Side Rendering (SSR) Issues
ReferenceError: window is not defined
This occurs when ECharts tries to access browser APIs during server-side rendering.
Solution:
tsx
Hydration mismatch errors
Server and client render different content, causing hydration issues.
Solution:
tsx
Performance Issues
Charts render slowly with large datasets
Large datasets can cause performance issues during rendering.
Solutions:
tsx
Memory leaks with multiple charts
Charts not properly disposed when components unmount.
Solution:
tsx
Styling and Theme Issues
Charts don't respect custom themes
Custom theme colors or styles are not being applied.
Solution:
tsx
Charts not responsive on mobile
Charts don't resize properly on smaller screens.
Solution:
tsx
Browser Compatibility
Charts not working in Internet Explorer
React ECharts Kit requires modern browser features.
Supported Browsers:
- Chrome 60+
- Firefox 55+
- Safari 12+
- Edge 79+
For older browser support:
tsx
Getting Help
If you're still experiencing issues, here are some resources:
- 📚Documentation: Check our comprehensive guides and API reference
- 💬GitHub Issues: Report bugs or request features on our GitHub repository
- 🤝Community: Join our Discord server for community support
- 📧Email Support: Contact us directly for enterprise support