# Migration (for AI assistants) **Category**: react **URL**: https://www.heroui.com/docs/react/migration/agent-index **Source**: https://raw.githubusercontent.com/heroui-inc/heroui/refs/heads/v3/apps/docs/content/docs/react/migration/agent-index.mdx > Entry point for AI assistants helping migrate HeroUI v2 to v3 *** For AI assistants: use this as the entry point when helping migrate HeroUI v2 → v3. ## Entry Choose a migration strategy: - **Full migration** (project will be broken during migration) → read `(workflows)/agent-guide-full.mdx`. - **Incremental** (v2 and v3 coexist) → read `(workflows)/agent-guide-incremental.mdx`. ## Reference in this bundle - **Cross-cutting guides:** `hooks.mdx`, `styling.mdx`. - The workflow guides above already inline the "major changes", "key API changes", component reference table, and "new components" sections. - **Per-component guides:** `(components)/.mdx` (e.g. `(components)/button.mdx`, `(components)/select.mdx`). Use the component reference table in the workflow guides to find the right file.