tailwindlabs/tailwindcss
v4.3.5A utility-first CSS framework powered by the high-speed Rust Oxide engine and CSS-first configuration.
Tailwind CSS is a utility-first styling framework that lets you design components directly in your HTML or JSX using small, composable class names. It removes the pain of inventing CSS class names, switching between files, and fighting unintended style overrides as your project grows.
Canonicalization: improve performance in projects with man. Drop-in upgrade. Migration: None.
Key Release Highlights (v4.3.5)
- Canonicalization: improve performance in projects with many functional variant values (e.g. a
matchVariantplugin with thousands of values) (#20663) - Don't crash or create a fallback with the wrong color for a
color-mix(…)without a color interpolation method (e.g.color-mix(var(--color-red-500))or `color-mix(currentcolo... - Ensure
@tailwindcss/oxide-wasm32-wasiloads instead of hanging forever (e.g. withNAPI_RS_FORCE_WASI=erroror in WebContainers) (#20667) - Remove
as: '*.css'from the@tailwindcss/turbopacksetup in its README, because it breaks CSS modules (#20660)
Verified safe drop-in upgrade for tailwindcss in package.json.
npm install tailwindcss@4.3.5Ecosystem Compatibility Matrix & Verified Graph Warnings
Verified BREAKS_WITH Graph Edges
Tailwind v4 replaces tailwind.config.js with CSS-first @theme blocks, breaking HSL plugin variables in legacy shadcn/ui registries. Run the OKLCH token codemod and upgrade shadcn to v2.4.0. Migration: Moderate.
npx @tailwindcss/upgrade@latest && npx shadcn@latest add --overwriteZero-Noise Historical Release Timeline (2)
Format: [Core Change] + [Required Action] + [Migration Effort]Canonicalization: improve performance in projects with man. Drop-in upgrade. Migration: None.
Add @tailwindcss/turbopack, a Turbopack loader for using. Drop-in upgrade. Migration: None.
Upgrade & Migration Q&A (tailwindlabs/tailwindcss v4.3.5)
Direct Answers for Engineers & AI AgentsIs tailwindlabs/tailwindcss v4.3.5 safe to upgrade in production?
tailwindlabs/tailwindcss v4.3.5 is classified as COMPATIBLE (PATCH release). Canonicalization: improve performance in projects with man. Drop-in upgrade. Migration: None.
What breaking changes or compatibility risks exist in tailwindlabs/tailwindcss v4.3.5?
tailwindcss with shadcn: Tailwind v4 replaces tailwind.config.js with CSS-first @theme blocks, breaking HSL plugin variables in legacy shadcn/ui registries. Run the OKLCH token codemod and upgrade shadcn to v2.4.0. Migration: Moderate.
What is the bundle size impact of tailwindcss v4.3.5?
tailwindcss v4.3.5 records a +0.1 kB (+0.2%) delta (oxide-engine), moving from 72,587 bytes to 72,706 bytes.
How do I upgrade tailwindcss to v4.3.5?
Upgrade tailwindcss to v4.3.5 by running "npm install tailwindcss@4.3.5" and applying the migration steps: npm install tailwindcss@4.3.5