Contract record

Tailwind CSS 4 CSS-first configuration and CLI contract

Tailwind CSS 4 changes package identity, CLI usage, config loading, browser target assumptions, and several utility semantics.

Use This When

Use this parent record for broad searches about the version change. Use a child repair page when the error, integration, runtime, or verification path is specific.

Child Repairs

Tailwind CSS v4 @config tailwind.config.js legacy configuration official docsCSS framework package and behavior drift · 5 observed queries Tailwind CSS v4 prefix syntax before utility name prefix docsCSS framework package and behavior drift · 5 observed queries Tailwind CSS v4 JavaScript config file not auto detected @config content sources theme tokens vanish upgradeBuild plugin/config relocation · 5 observed queries Tailwind CSS v4 arbitrary CSS variable syntax migration var parentheses officialCSS framework package and behavior drift · 4 observed queries Tailwind CSS v4 browser support Safari 16.4 officialCSS framework package and behavior drift · 4 observed queries Tailwind CSS v4 CLI @tailwindcss/cli npx tailwindcss command not found official docsCSS framework package and behavior drift · 4 observed queries Tailwind CSS v4 important modifier order changed official important modifier syntaxCSS framework package and behavior drift · 4 observed queries Tailwind CSS v4 ring utility default width color changed ring docsCSS framework package and behavior drift · 3 observed queries Tailwind CSS v4 upgrade guide default border color changed currentColor gray-200CSS framework package and behavior drift · 3 observed queries Tailwind CSS v4 automatic content detection monorepo source directive @source linked workspace packageBuild plugin/config relocation · 3 observed queries Tailwind CSS v4 PostCSS plugin @tailwindcss/postcss tailwindcss cannot be used directly as a PostCSS pluginBuild plugin/config relocation · 3 observed queries Tailwind CSS v4 removed renamed utilities upgrade guide renamed utilities shadow outline ring blurBuild plugin/config relocation · 3 observed queries Tailwind CSS v4 upgrade guide @tailwind base components utilities @import "tailwindcss"Build plugin/config relocation · 3 observed queries Tailwind CSS v4 Vite plugin @tailwindcss/vite official docsBuild plugin/config relocation · 3 observed queries