Livewire UI Components - v1.0-beta2
Migration Guides
This section contains migration guides to help you upgrade between different versions of ArtisanPack UI Livewire Components or when component APIs change significantly.
Overview
Migration guides provide step-by-step instructions for updating your code when breaking changes are introduced. Each guide includes:
- What changed: Clear explanation of the changes and why they were made
- Migration scenarios: Different use cases and how to handle each one
- Code examples: Before and after code snippets showing the exact changes needed
- Troubleshooting: Common issues and their solutions
Available Migration Guides
Component Migrations
- ImageGallery Component Migration - Guide for migrating from the old carousel-based ImageGallery component to the new ImageSlider and grid-based ImageGallery components
Migration Best Practices
When migrating your components, we recommend:
- Read the entire guide before starting the migration
- Test in a development environment first
- Update one component at a time to isolate any issues
- Review breaking changes in the changelog
- Check for deprecated features that may need updating
Getting Help
If you encounter issues during migration:
- Check the troubleshooting section in the relevant migration guide
- Review the GitLab Issues for similar problems
- Create a new issue with details about your migration problem
- Contact support at me@jacobmartella.com
Contributing
Found an issue with a migration guide or have suggestions for improvement? We welcome contributions to help make migrations smoother for everyone. Please open an issue or submit a merge request on GitLab.