tailwindcss breaking changes

npm

3 curated breaking changes across major versions of tailwindcss. Use this as a migration checklist before bumping dependencies.

3
changes
Breaking changes by transition
  • 3 \u2192 4api

    `@tailwind base; @tailwind components; @tailwind utilities;` replaced by a single `@import "tailwindcss";`.

    Migration

    Run codemod: `npx @tailwindcss/upgrade`. It rewrites directives and config.

  • 3 \u2192 4build

    New Oxide engine (Rust). `tailwind.config.js` optional; CSS-first configuration via @theme.

    Migration

    Keep config for complex setups. For simple apps, replace with `@import "tailwindcss";` and `@theme { ... }` in your CSS.

  • 3 \u2192 4removal

    Deprecated utilities removed (bg-opacity-*, text-opacity-*, etc.).

    Migration

    Use the slash syntax: `bg-white/50` instead of `bg-white bg-opacity-50`.

API access

Get this data programmatically \u2014 free, no authentication.

curl https://depscope.dev/api/breaking/npm/tailwindcss
tailwindcss breaking changes — npm migration guide | DepScope