Migration guides

Primer ViewComponents are routinely deprecated as they mature. The following guides detail performing component upgrades.

Migrating from Primer CSS

Many Primer CSS use cases are supported by Primer ViewComponents.

When migrating from Primer CSS classes to ViewComponents, use this mapping to help guide your implementation. This list includes components currently in stable status.

Upgrading deprecated components

As Primer ViewComponents are updated, there are often breaking changes and deprecations that require changes which cannot be auto-corrected with Rubocop or other tools. These guides will walk you through the upgrade process for specific components.