Livewire UI Components - v1.0.0
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.