Upgrade guide

Moving from Strata 2 to 3? Most projects upgrade in under an hour with the automated codemod. This guide covers what it changes and what needs your attention.

Updated Sep 02, 2026 6 min readMigrationv3

Run the codemod

Commit your work first. The codemod rewrites config, renames classes and updates imports in place.

npm

pnpm

bun

yarn

$ npx @strata/cli@latest upgrade --to 3

Renamed utilities

Strata 2	Strata 3	Why
shadow-sm	elevation-1	Elevation is now a token scale
rounded	radius-md	Matches the radius tokens
flex-col gap-*	stack gap-*	New layout primitive
text-gray-500	text-muted	Semantic colour names

Breaking changes

strata.config.js must become strata.config.ts and export defineConfig().
The important option is removed — cascade layers make it unnecessary.
darkMode: "media" is now colorScheme: "system".
React bindings moved from strata/react to @strata/react.

Was this page helpful?

Last edited Sep 02, 2026 · docs/upgrade-guide.mdx