---
title: Migration
editUrl: https://github.com/Cratis/Components/edit/main/Documentation/Migration/index.md
description: Move @cratis/components applications between major versions with focused upgrade guides.
---


Guides for moving `@cratis/components` forward across major versions. Each guide is scoped to one version jump and lists the changes a consuming application can observe: dependencies, imports, styling, licensing, behavior, and verification.

| Guide | Covers |
| --- | --- |
| [2.x → 3.0](/components/migration/2-to-3/) | PrimeReact 10 → 11, peer dependencies, styling, and PrimeUI licensing |
| [3.x → 4.0](/components/migration/3-to-4/) | Renderer-independent Components APIs, explicit subpaths, styling parts, and migration tooling |

When moving from PrimeReact 10 to 11, also read PrimeReact's [Updating to v11](https://primereact.dev/docs/primitive/guides/migration/updating-to-v11) guide alongside [2.x → 3.0](/components/migration/2-to-3/). The [3.x → 4.0](/components/migration/3-to-4/) guide covers the separate Components migration away from PrimeReact-backed public APIs. A 2.x application can skip Components 3 and follow [Migrate directly from Components 2](/components/migration/3-to-4/#migrate-directly-from-components-2).