Claude MarketplacesSubmit
heroui-inc avatar

Heroui Migration

heroui-inc/herouiOfficial

If you're upgrading a HeroUI v2 app to v3, this skill walks you through the breaking changes: compound components replacing flat props, no more Provider wrapper, onPress instead of onClick, and a full styling overhaul for Tailwind v4. It includes scripts to fetch migration docs from staging, component-specific guides for Button, Card, Modal and others, and supports both full rewrites and incremental migrations using pnpm aliases. The documentation fetching approach is smart since v3 patterns are different enough that you shouldn't guess. Worth noting this targets a preview deployment, so you'll need to update the base URL once the migration docs go live on heroui.com.

skills.sh installs
4.4K
GitHub stars
31.2K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add heroui-inc/heroui --skill heroui-migration --agent claude-code

Installs into .claude/skills of the current project.

Files

HeroUI v2 to v3 Migration Guide

This skill helps agents migrate HeroUI v2 applications to v3. HeroUI v3 introduces breaking changes: compound components, no Provider, Tailwind v4, and removed hooks.

Installation

curl -fsSL https://heroui.com/install | bash -s heroui-migration

CRITICAL: Always Fetch Migration Docs Before Applying

Do NOT assume v2 patterns work in v3. Always fetch migration guides before implementing changes.

Key v2 → v3 Changes

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/heroui-inc/heroui
Category
Documentation
First seen
Apr 16, 2026

More from heroui-inc/heroui

All 3

Recommended

More Documentation
1lobehub avatartestinglobehub/lobehubVitest testing guide. Use when writing or updating tests, fixing failing tests, improving coverage, debugging test issues, or setting up mocks.4.3Kskills.sh installs
2amelnagdy avatartest-guardamelnagdy/guard-skillsReview generated or changed test code against universal testing rules before it ships. Best used reactively after an agent writes, edits, generates, or refactor4.3Kskills.sh installs
3softaworks avatarcrafting-effective-readmessoftaworks/agent-toolkitUse when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.4.2Kskills.sh installs
4tobi avatarqmdtobi/qmdSearch local markdown knowledge bases, notes, docs, and wikis with QMD. Use when users ask to find notes, retrieve documents, inspect a wiki, answer from indexe4.1Kskills.sh installs
5softaworks avatarreact-useeffectsoftaworks/agent-toolkitReact useEffect best practices from official docs. Use when writing/reviewing useEffect, useState for derived values, data fetching, or state synchronization. T4.1Kskills.sh installs
6dotnet avatarmaui-themingdotnet/skillsGuide for theming .NET MAUI apps — light/dark mode via AppThemeBinding, ResourceDictionary theme switching, DynamicResource bindings, system theme detection, an3.9Kskills.sh installs