Migration Guide
This guide helps you migrate between major versions of 3Lens.
Upgrading to v1.x
If you're starting fresh with 3Lens v1.x, no migration is needed! Follow the Getting Started guide.
Future Migrations
When new major versions are released, migration guides will be added here:
- v1.x → v2.x - Coming with v2.0 release
- v2.x → v3.x - Future
Version Support Policy
| Version | Status | Support |
|---|---|---|
| v1.x | Current | ✅ Active development |
| v0.x | N/A | Not applicable (pre-release) |
Support Levels
- Active Development: New features, bug fixes, security patches
- Maintenance: Security patches and critical bug fixes only
- Deprecated: No updates, documentation archived
- End of Life: No support, documentation may be removed
Breaking Changes
How We Handle Breaking Changes
3Lens follows Semantic Versioning:
- Major versions (v1 → v2): May include breaking changes
- Minor versions (v1.0 → v1.1): New features, backward compatible
- Patch versions (v1.0.0 → v1.0.1): Bug fixes only
Breaking Change Policy
Before any breaking change:
- Deprecation warning in previous minor version
- Migration guide with code examples
- Codemod (automated migration) when possible
- Minimum 3 months notice for major changes
Getting Help
If you encounter issues during migration:
- Check the Changelog for detailed changes
- Search GitHub Issues
- Ask in GitHub Discussions
- Join our Discord community (coming soon)
Version Compatibility Matrix
Three.js Versions
| 3Lens | Three.js | Notes |
|---|---|---|
| v1.x | r150+ | WebGPU support requires r152+ |
Framework Versions
| 3Lens | React | Angular | Vue |
|---|---|---|---|
| v1.x | 18+ | 16+ | 3.3+ |
Browser Support
| 3Lens | Chrome | Firefox | Safari | Edge |
|---|---|---|---|---|
| v1.x | 90+ | 90+ | 15+ | 90+ |
WebGPU Requirements
WebGPU features require Chrome 113+ or other browsers with WebGPU enabled.
Next Steps
- Getting Started - Fresh installation guide
- Configuration - Configure 3Lens options
- First Debugging Session - Start debugging