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:

  1. Read the entire guide before starting the migration
  2. Test in a development environment first
  3. Update one component at a time to isolate any issues
  4. Review breaking changes in the changelog
  5. 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.