{"enrichment":{"faq":[{"a":"HeroUI-migration guides you through upgrading HeroUI from v2 to v3 with step-by-step instructions. Start by updating your package dependencies, then address breaking changes like removing the Provider wrapper, updating event handlers from onClick to onPress, and migrating to compound components. The skill supports both full migration (all at once) and incremental migration (component by component) strategies based on your project needs.","q":"How do I upgrade HeroUI from v2 to v3?"},{"a":"HeroUI-migration documents key breaking changes including the removal of the Provider requirement, renaming of event handlers (onClick becomes onPress), adoption of compound components for complex UI patterns, and styling adjustments for Tailwind v4 compatibility. Each change is explained with migration examples to help you understand the impact on your existing v2 code and how to adapt components accordingly.","q":"What are the main breaking changes in HeroUI v3?"},{"a":"HeroUI-migration helps you choose between full and incremental migration strategies. Full migration updates your entire application at once, ideal for smaller projects or when you want a clean break. Incremental migration updates components gradually, reducing risk and allowing parallel testing. The skill provides guidance for both approaches, including how to manage dependencies and maintain stability during the transition.","q":"Should I do a full or incremental migration to HeroUI v3?"},{"a":"HeroUI-migration covers styling updates required for v3, including className/classNames changes and Tailwind v4 compatibility adjustments. For hooks, the skill provides migration documentation showing which hooks changed, were removed, or require new parameters. Component-specific examples demonstrate how to update your custom styling and hook usage to work with v3's new architecture.","q":"What styling and hooks need updating for HeroUI v3?"},{"a":"HeroUI-migration clarifies that v3 removes the Provider requirement that was mandatory in v2. This simplifies setup and reduces boilerplate code. The skill explains how to remove Provider wrappers from your application structure and what configuration changes are needed to ensure your components function correctly without this wrapper in the v3 architecture.","q":"Does HeroUI v3 still require a Provider wrapper?"},{"a":"HeroUI-migration provides component-specific migration documentation and examples for each HeroUI component. It shows how compound components work in v3, demonstrates event handler renaming (onClick to onPress), and explains prop changes. The skill includes practical code examples for common components, helping you understand the exact changes needed for your application's component usage.","q":"How do I migrate HeroUI components from v2 to v3?"}],"shadow_tags":["component-upgrade","breaking-changes","api-refactor","incremental-strategy","dependency-management","event-handler-mapping","compound-pattern","styling-migration"],"summary_rewrite":"This skill guides agents through upgrading HeroUI v2 applications to v3, addressing breaking changes like compound components, removed Provider requirements, and event handler renaming. It provides migration workflows for both full and incremental approaches, component-specific guides, and styling updates to keep projects functional during the transition."},"files":[{"bytes":4582,"path":"skills/heroui-migration/SKILL.md","sha256":"a8a5a9b61e27ffb84b0d0c27f24d79c10537509f99933547b3230362d1a65980","url":"https://skillfed.io/files/heroui-inc/heroui/heroui-migration/cfba8476/SKILL.md"}],"id":"heroui-inc/heroui/heroui-migration","links":{"html":"https://skillfed.io/heroui-inc/heroui/heroui-migration","md":"https://skillfed.io/heroui-inc/heroui/heroui-migration.md","repo":"https://github.com/heroui-inc/heroui"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":2204,"language":"MDX","last_updated":"2026-07-28","license":"Apache-2.0","name":"heroui-migration","publisher":"heroui-inc","stars":30221},"relations":{"similar":[{"id":"heroui-inc/heroui/heroui-react"},{"id":"ruchernchong/claude-kit/heroui"},{"id":"heroui-inc/heroui/heroui-native"},{"id":"AkaraChen/aghub/heroui-react"},{"id":"AkaraChen/aghub/project-form-patterns"},{"id":"rand/cc-polymath/elegant-design"},{"id":"proffesor-for-testing/agentic-qe/qe-aqe-v2-v3-migration"},{"id":"lodev09/react-native-true-sheet/truesheet-usage"},{"id":"gluestack/agent-skills/migrate-to-v5"},{"id":"wshobson/agents/react-native-design"}]},"slug":{"owner":"heroui-inc","repo":"heroui","skill":"heroui-migration"},"version":"cfba8476"}