Tailwind CSS Changelog File — Tailwind CSS

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

Add @tailwindcss/turbopack package to run Tailwind CSS with Next.js (20367)

Fixed

Ensure watch mode detects changes to symlinked @source files whose real paths aren't otherwise scanned (#20356)
Ensure custom variants using @scope wrap the generated utilities instead of nesting inside them (#20369)
Fix flattening of @scope at-rules (#20369)
Fix standalone declarations in @scope, wrap them in :where(:scope) (#20369)
Always emit a space for empty fallback values in CSS variables (e.g. var(--tw-blur,) → var(--tw-blur, )) (#20373)
Canonicalization: convert arbitrary breakpoint and container query variants to named equivalents (e.g. max-[64rem] → max-lg) (#20380)
Prevent @tailwindcss/vite from crashing on every edit under Vite's experimental bundledDev mode (#20379)
Ensure @tailwindcss/oxide falls back to WASM on platforms without native bindings (#20383)
Detect classes in Ruby percent literals using angle brackets or custom delimiters (e.g. %w<flex>, %w|flex|), including in Slim and Haml templates (#20387)
Preserve whitespace in --default(…) values in custom functional utilities (e.g. --default(box alphabetic) no longer becomes boxalphabetic) (#20392)
Don't scan gitignored directories (e.g. node_modules and .git) when the project uses a safelist-style .gitignore (e.g. /* followed by !/… negations) (#20397)
Ensure root theme('…') namespace lookups in JavaScript plugins and config files return the full namespace object instead of the value of its DEFAULT key (#20399)
Skip ignored directories entirely when computing watch globs (scanner.globs), instead of walking their full contents on every rebuild (#20408)
Oxide: drop invalid UTF-8 candidates (#20389)
@tailwindcss/vite no longer forces a full page reload for external files (e.g.: .php files) (#20414)
Canonicalization: don't merge utilities that reference different theme variables set to CSS-wide keywords like unset (#20417)
Don't generate utilities when a modifier is used that would otherwise be silently ignored (e.g. rounded-sm/[5], shadow-sm/foo, stroke-2/50) (#20419)
Only normalize top-level and, or, and not keywords in supports-[…] variants (e.g. selector(a: not (.foo)) → selector(a:not(.foo))) (#20420)
Don't warn about Angular's ::ng-deep and :host-context() when optimizing CSS (#20434)
Don't generate CSS for candidates containing an empty additional modifier (e.g. bg-red-500/50/ and group-hover/foo//bar:flex) (#20466)
Sort min-*, max-*, and container query variants with decimal values numerically (e.g. min-[40.25rem] before min-[40.5rem]) (#20512)
Ensure CSS comments ending with \*/ are closed correctly instead of swallowing the CSS that follows (e.g. /* C:\temp\*/) (#20508)
Improve style invalidation performance of group-* and peer-* variants (#20513)
Ensure cached compilers don't keep loadModule and loadStylesheet callbacks alive after compilation (#20531)
Canonicalization: keep the & when moving a pseudo-element into * or ** (e.g. [&_::before]:flex → **:[&::before]:flex) (#20550)
Fix Set.prototype.intersection polyfill in canonicalizeCandidates(…) on Node.js < 22, which returned the first set instead of the intersection (#20562)
Canonicalization: fix inline theme(…) alphas with more than 2 decimals being migrated to a modifier that changes the opacity by a factor of 100 (e.g. theme(colors.red.500/.12345) → text-red-500/[12.345%], not text-red-500/[12.345]) (#20563)
Canonicalization: keep inline theme(…) alphas as an arbitrary percentage when a custom --opacity-* theme value would change the opacity (e.g. theme(colors.red.500/50%) → text-red-500/[50%] with --opacity-50: 10%) (#20563)

[4.3.3] - 2026-07-16

Fixed

Support --watch --poll[=ms] in @tailwindcss/cli when filesystem events are unreliable or unavailable (#20297)
Canonicalization: match arbitrary hex colors against theme colors case-insensitively (e.g. bg-[#fff] and bg-[#FFF] → bg-white) (#20298)
Prevent Preflight from overriding Firefox's native iframe:focus-visible outline styles (#20292)
Ensure theme('colors.foo') in JS plugins resolves correctly when both --color-foo and --color-foo-bar exist (#20299)
Ensure fractional opacity modifiers work with named shadow sizes like shadow-sm/12.5, text-shadow-sm/12.5, drop-shadow-sm/12.5, and inset-shadow-sm/12.5 (#20302)
Parse selectors like [data-foo]div as two selectors instead of one (#20303)
Ensure @tailwindcss/postcss rebuilds when a preprocessor like Sass changes the input CSS without changing the input file on disk (#20310)
Ensure CSS nesting is handled even when Lightning CSS isn't run, such as in @tailwindcss/browser and Tailwind Play (#20124)
Prevent achromatic theme colors from shifting hue when mixed in polar color spaces like oklch (#20314)
Ensure --spacing(0) is optimized to 0px instead of 0 so it remains a <length> when used in calc(…) (#20319)
Load @parcel/watcher only when needed in @tailwindcss/cli --watch mode, so one-off builds and --watch --poll work when @parcel/watcher can't be loaded (#20325)
Use explicit platform fonts instead of system-ui and ui-sans-serif so CJK text respects the page's lang attribute on Windows (#20318)
Prevent @tailwindcss/upgrade from rewriting ignored files when run from a subdirectory (#20329)
Ensure earlier @source rules pointing to nested files are scanned when later @source rules point to files in parent folders (#20335)
Prevent @tailwindcss/vite from triggering full page reloads when scanned files are processed by Vite but haven't been loaded as modules yet (#20336)

[4.3.2] - 2026-06-26

Fixed

Support bare spacing values for auto-rows-* and auto-cols-* utilities (e.g. auto-rows-12 and auto-cols-16) (#20229)
Prevent @tailwindcss/cli in --watch mode from crashing on Windows when @source points to a directory that doesn't exist (#20242)
Prevent @tailwindcss/vite from crashing in Deno v2.8.x when context.parentURL is not a valid URL (#20245)
Ensure @tailwindcss/cli in --watch mode rebuilds when the input CSS file changes in an ignored directory (#20246)
Allow @variant rules used in addBase(…) to use custom variants defined later (#20247)
Prevent @tailwindcss/vite from crashing during HMR when scanned files or directories are deleted (#20259)
Generate font-size instead of color declarations for text-[--spacing(…)] (#20260)
Prevent @source patterns from scanning unrelated sibling files and folders (#20263)
Extract class candidates adjacent to Template Toolkit delimiters like %]…[% in .tt, .tt2, and .tx files (#20269)
Extract class candidates from conditional Maud syntax like p.text-black[condition] (#20269)
Prevent @position-try rules from triggering unknown at-rule warnings when optimizing CSS (#20277)
Support class suggestions for named opacity modifiers from --opacity theme values (#20287)
Prevent type errors in @tailwindcss/postcss when used with newer PostCSS patch releases (#20289)

[4.3.1] - 2026-06-12

Added

Add --silent option to suppress output in @tailwindcss/cli (#20100)

Fixed

Remove deprecation warnings by using Module#registerHooks instead of Module#register on Node 26+ (#20028)
Canonicalization: don't crash when plugin utilities throw for unsupported values (#20052)
Allow @apply to be used with CSS mixins (#19427)
Ensure not-* correctly negates @container queries, including style(…) queries (#20059)
Ensure drop-shadow-* color utilities work with custom shadow values containing calc(…) (#20080)
Fix 'Sourcemap is likely to be incorrect' warnings when using @tailwindcss/vite (#20103)
Ensure @tailwindcss/webpack can be installed in Rspack projects without requiring webpack as a peer dependency (#20027)
Canonicalization: don't suggest invalid calc(…) expressions (e.g. px-[calc(1rem+0px)] → px-[calc(1rem+0)]) (#20127)
Canonicalization: avoid suggesting large spacing-scale values for arbitrary lengths (e.g. left-[99999px] → left-[99999px], not left-24999.75) (#20130)
Ensure @tailwindcss/cli in --watch mode recovers when a tracked dependency is deleted and restored (#20137)
Ensure standalone @tailwindcss/cli binaries are ignored when scanning for class candidates (#20139)
Ensure class candidates are extracted from Twig addClass(…) and removeClass(…) calls (#20198)
Don't crash in the Ruby or Vue preprocessors when scanning files containing invalid UTF-8 bytes (#19588)
Allow @variant to be used inside addBase (#19480)
Ensure @source globs with symlinks are preserved (#20203)
Ensure later @source rules can re-include files excluded by earlier @source not rules (#20203)
Upgrade: don't migrate empty class rules to invalid @utility rules (#20205)
Ensure transitions between inset-shadow-none and other inset shadows work correctly (#20208)
Ensure explicitly referenced @source directories are scanned even when ignored by git (#20214)
Ensure @source globs ending in **/* preserve dynamic path segments to avoid scanning too many files (#20217)
Canonicalization: don't fold calc(…) divisions when the result would require high precision (e.g. w-[calc(100%/3.5)] → w-[calc(100%/3.5)], not w-[28.571428571428573%]) (#20221)
Serve ESM type declarations to ESM importers of @tailwindcss/postcss (#20228)

Changed

Generate 0 instead of calc(var(--spacing) * 0) for spacing utilities like m-0 and left-0 (#20196)
Generate var(--spacing) instead of calc(var(--spacing) * 1) for spacing utilities like m-1 and left-1 (#20196)

[4.3.0] - 2026-05-08

Added

Add @container-size utility (#18901)
Add scrollbar-{auto,thin,none} utilities for scrollbar-width, and scrollbar-thumb-* / scrollbar-track-* color utilities for scrollbar-color (#19981, #20019)
Add scrollbar-gutter-* utilities (#20018)
Add zoom-* utilities (#20020)
Add tab-* utilities (#20022)
Allow using @variant with stacked variants (e.g. @variant hover:focus { … }) (#19996)
Allow using @variant with compound variants (e.g. @variant hover, focus { … }) (#19996)
Support --default(…) in --value(…) and --modifier(…) for functional @utility definitions (#19989)

Fixed

Ensure @plugin resolves package JavaScript entries instead of browser CSS entries when using @tailwindcss/vite (#19949)
Fix relative @import and @plugin paths resolving from the wrong directory when using @tailwindcss/vite (#19965)
Ensure CSS files containing @variant are processed by @tailwindcss/vite (#19966)
Resolve imports relative to base when result.opts.from is not provided when using @tailwindcss/postcss (#19980)
Canonicalization: preserve significant _ whitespace in arbitrary values (#19986)
Canonicalization: add parentheses when removing whitespace from arbitrary values would hurt readability (e.g. w-[calc(100%---spacing(60))] → w-[calc(100%-(--spacing(60)))]) (#19986)
Canonicalization: preserve the original unit in arbitrary values instead of normalizing to base units (e.g. -mt-[20in] → mt-[-20in], not mt-[-1920px]) (#19988)
Canonicalization: migrate arbitrary :has() variants from [&:has(…)] to has-[…] (#19991)
Upgrade: don’t migrate inline style attributes (e.g. style="flex-grow: 1" → style="flex-grow: 1", not style="grow: 1") (#19918)
Allow multiple @utility definitions with the same name but different value types (#19777)
Export missing PluginWithConfig type from tailwindcss/plugin to fix errors when inferring plugin config types (#19707)
Ensure start and end legacy utilities without values do not generate CSS (#20003)
Ensure --value(…) is required in functional @utility definitions (#20005)
Canonicalization: preserve required whitespace around operators in negated arbitrary values (e.g. -left-[(var(--a)+var(--b))]) (#20011)

[4.2.4] - 2026-04-21

Fixed

Ensure imports in @import and @plugin still resolve correctly when using Vite aliases in @tailwindcss/vite (#19947)

[4.2.3] - 2026-04-20

Fixed

Canonicalization: improve canonicalization for tracking-* utilities by preferring non-negative utilities (e.g. -tracking-tighter → tracking-wider) (#19827)
Fix crash due to invalid characters in candidate (exceeding valid unicode code point range) (#19829)
Ensure query params in imports are considered unique resources when using @tailwindcss/webpack (#19723)
Canonicalization: collapse arbitrary values into shorthand utilities (e.g. px-[1.2rem] py-[1.2rem] → p-[1.2rem]) (#19837)
Canonicalization: collapse border-{t,b}-* into border-y-*, border-{l,r}-* into border-x-*, and border-{t,r,b,l}-* into border-* (#19842)
Canonicalization: collapse scroll-m{t,b}-* into scroll-my-*, scroll-m{l,r}-* into scroll-mx-*, and scroll-m{t,r,b,l}-* into scroll-m-* (#19842)
Canonicalization: collapse scroll-p{t,b}-* into scroll-py-*, scroll-p{l,r}-* into scroll-px-*, and scroll-p{t,r,b,l}-* into scroll-p-* (#19842)
Canonicalization: collapse overflow-{x,y}-* into overflow-* (#19842)
Canonicalization: collapse overscroll-{x,y}-* into overscroll-* (#19842)
Read from --placeholder-color instead of --background-color for placeholder-* utilities (#19843)
Upgrade: ensure files are not emptied out when killing the upgrade process while it's running (#19846)
Upgrade: use config.content when migrating from Tailwind CSS v3 to Tailwind CSS v4 (#19846)
Upgrade: never migrate files that are ignored by git (#19846)
Add .env and .env.* to default ignored content files (#19846)
Canonicalization: migrate overflow-ellipsis into text-ellipsis (#19849)
Canonicalization: migrate start-full → inset-s-full, start-auto → inset-s-auto, start-px → inset-s-px, and start-<number> → inset-s-<number> as well as negative versions (#19849)
Canonicalization: migrate end-full → inset-e-full, end-auto → inset-e-auto, end-px → inset-e-px, and end-<number> → inset-e-<number> as well as negative versions (#19849)
Canonicalization: move the - sign inside the arbitrary value -left-[9rem] → left-[-9rem] (#19858)
Canonicalization: move the - sign outside the arbitrary value ml-[calc(-1*var(--width))] → -ml-(--width) (#19858)
Improve performance when scanning JSONL / NDJSON files (#19862)
Support NODE_PATH environment variable in standalone CLI (#19617)

[4.2.2] - 2026-03-18

Fixed

Don't crash when candidates contain prototype properties like row-constructor (#19725)
Canonicalize calc(var(--spacing)*…) expressions into --spacing(…) (#19769)
Fix crash in canonicalization step when handling utilities containing @property at-rules (e.g. shadow-sm border) (#19727)
Skip full reload for server only modules scanned by client CSS when using @tailwindcss/vite (#19745)
Add support for Vite 8 in @tailwindcss/vite (#19790)
Improve canonicalization for bare values exceeding default spacing scale suggestions (e.g. w-1234 h-1234 → size-1234) (#19809)
Fix canonicalization resulting in empty list (e.g. w-5 h-5 size-5 → '' instead of size-5) (#19812)
Resolve tsconfig paths to allow for @import '@/path/to/file'; when using @tailwindcss/vite (#19803)

[4.2.1] - 2026-02-23

Fixed

Allow trailing dash in functional utility names for backwards compatibility (#19696)
Properly detect classes containing . characters within curly braces in MDX files (#19711)

[4.2.0] - 2026-02-18

Added

Add mauve, olive, mist, and taupe color palettes to the default theme (#19627)
Add @tailwindcss/webpack package to run Tailwind CSS as a webpack plugin (#19610)
Add pbs-* and pbe-* utilities for padding-block-start and padding-block-end (#19601)
Add mbs-* and mbe-* utilities for margin-block-start and margin-block-end (#19601)
Add scroll-pbs-* and scroll-pbe-* utilities for scroll-padding-block-start and scroll-padding-block-end (#19601)
Add scroll-mbs-* and scroll-mbe-* utilities for scroll-margin-block-start and scroll-margin-block-end (#19601)
Add border-bs-* and border-be-* utilities for border-block-start and border-block-end (#19601)
Add inline-*, min-inline-*, max-inline-* utilities for inline-size, min-inline-size, and max-inline-size (#19612)
Add block-*, min-block-*, max-block-* utilities for block-size, min-block-size, and max-block-size (#19612)
Add inset-s-*, inset-e-*, inset-bs-*, inset-be-* utilities for inset-inline-start, inset-inline-end, inset-block-start, and inset-block-end (#19613)
Add font-features-* utility for font-feature-settings (#19623)

Fixed

Prevent double @supports wrapper for color-mix values (#19450)
Allow whitespace around @source inline() argument (#19461)
Emit comment when source maps are saved to files when using @tailwindcss/cli (#19447)
Detect utilities containing capital letters followed by numbers (#19465)
Fix class extraction for Rails' strict locals (#19525)
Align @utility name validation with Oxide scanner rules (#19524)
Fix infinite loop when using @variant inside @custom-variant (#19633)
Allow multiples of .25 in aspect-* fractions (e.g. aspect-8.5/11) (#19688)
Ensure changes to external files listed via @source trigger a full page reload when using @tailwindcss/vite (#19670)
Improve performance of Oxide scanner in bigger projects by reducing file system walks (#19632)
Ensure import aliases in Astro v5 work without crashing when using @tailwindcss/vite (#19677)
Allow escape characters in @utility names to improve support with formatters such as Biome (#19626)
Fix incorrect canonicalization results when canonicalizing multiple times (#19675)
Add .jj to default ignored content directories (#19687)

Deprecated

Deprecate start-* and end-* utilities in favor of inset-s-* and inset-e-* utilities (#19613)

[4.1.18] - 2025-12-11

Fixed

Ensure validation of source(…) happens relative to the file it is in (#19274)
Include filename and line numbers in CSS parse errors (#19282)
Skip comments in Ruby files when checking for class names (#19243)
Skip over arbitrary property utilities with a top-level ! in the value (#19243)
Support environment API in @tailwindcss/vite (#18970)
Preserve case of theme keys from JS configs and plugins (#19337)
Write source maps correctly on the CLI when using --watch (#19373)
Handle special defaults (like ringColor.DEFAULT) in JS configs (#19348)
Improve backwards compatibility for content theme key from JS configs (#19381)
Upgrade: Handle future and experimental config keys (#19344)
Try to canonicalize any arbitrary utility to a bare value (#19379)
Validate candidates similarly to Oxide (#19397)
Canonicalization: combine text-* and leading-* classes (#19396)
Correctly handle duplicate CLI arguments (#19416)
Don’t emit color-mix fallback rules inside @keyframes (#19419)
CLI: Don't hang when output is /dev/stdout (#19421)

[3.4.19] - 2025-12-10

Fixed

Don’t break sibling-*() functions when used inside calc(…) (#19335)

[4.1.17] - 2025-11-06

Fixed

Substitute @variant inside legacy JS APIs (#19263)
Prevent occasional crash on Windows when loaded into a worker thread (#19242)

[4.1.16] - 2025-10-23

Fixed

Discard candidates with an empty data type (#19172)
Fix canonicalization of arbitrary variants with attribute selectors (#19176)
Fix invalid colors due to nested & (#19184)
Improve canonicalization for & > :pseudo and & :pseudo arbitrary variants (#19178)

[4.1.15] - 2025-10-20

Fixed

Fix Safari devtools rendering issue due to color-mix fallback (#19069)
Suppress Lightning CSS warnings about :deep, :slotted, and :global (#19094)
Fix resolving theme keys when starting with the name of another theme key in JS configs and plugins (#19097)
Allow named groups in combination with not-*, has-*, and in-* (#19100)
Prevent important utilities from affecting other utilities (#19110)
Don’t index into strings with the theme(…) function (#19111)
Fix parsing issue when \t is used in at-rules (#19130)
Upgrade: Canonicalize utilities containing 0 values (#19095)
Upgrade: Migrate deprecated break-words to wrap-break-word (#19157)

Changed

Remove the postinstall script from oxide ([#19149])(https://github.com/tailwindlabs/tailwindcss/pull/19149)

[4.1.14] - 2025-10-01

Fixed

Handle ' syntax in ClojureScript when extracting classes (#18888)
Handle @variant inside @custom-variant (#18885)
Merge suggestions when using @utility (#18900)
Ensure that file system watchers created when using the CLI are always cleaned up (#18905)
Do not generate grid-column utilities when configuring grid-column-start or grid-column-end (#18907)
Do not generate grid-row utilities when configuring grid-row-start or grid-row-end (#18907)
Prevent duplicate CSS when overwriting a static utility with a theme key (#18056)
Show Lightning CSS warnings (if any) when optimizing/minifying (#18918)
Use default export condition for @tailwindcss/vite (#18948)
Re-throw errors from PostCSS nodes (#18373)
Detect classes in markdown inline directives (#18967)
Ensure files with only @theme produce no output when built (#18979)
Support Maud templates when extracting classes (#18988)
Upgrade: Do not migrate variant = 'outline' during upgrades (#18922)
Upgrade: Show version mismatch (if any) when running upgrade tool (#19028)
Upgrade: Ensure first class inside className is migrated (#19031)
Upgrade: Migrate classes inside *ClassName and *Class attributes (#19031)

[3.4.18] - 2025-10-01

Fixed

Improve support for raw supports-[…] queries in arbitrary values (#13605)
Fix require.cache error when loaded through a TypeScript file in Node 22.18+ (#18665)
Support import.meta.resolve(…) in configs for new enough Node.js versions (#18938)
Allow using newer versions of postcss-load-config for better ESM and TypeScript PostCSS config support with the CLI (#18938)
Remove irrelevant utility rules when matching important classes (#19030)

[4.1.13] - 2025-09-03

Changed

Drop warning from browser build (#18731)
Drop exact duplicate declarations when emitting CSS (#18809)

Fixed

Don't transition visibility when using transition (#18795)
Discard matched variants with unknown named values (#18799)
Discard matched variants with non-string values (#18799)
Show suggestions for known matchVariant values (#18798)
Replace deprecated clip with clip-path in sr-only (#18769)
Hide internal fields from completions in matchUtilities (#18820)
Ignore .vercel folders by default (can be overridden by @source … rules) (#18855)
Consider variants starting with @- to be invalid (e.g. @-2xl:flex) (#18869)
Do not allow custom variants to start or end with a - or _ (#18867, #18872)
Upgrade: Migrate aria theme keys to @custom-variant (#18815)
Upgrade: Migrate data theme keys to @custom-variant (#18816)
Upgrade: Migrate supports theme keys to @custom-variant (#18817)

[4.1.12] - 2025-08-13

Fixed

Don't consider the global important state in @apply (#18404)
Add missing suggestions for flex-<number> utilities (#18642)
Fix trailing ) from interfering with extraction in Clojure keywords (#18345)
Detect classes inside Elixir charlist, word list, and string sigils (#18432)
Track source locations through @plugin and @config (#18345)
Allow boolean values of process.env.DEBUG in @tailwindcss/node (#18485)
Ignore consecutive semicolons in the CSS parser (#18532)
Center the dropdown icon added to an input with a paired datalist by default (#18511)
Extract candidates in Slang templates (#18565)
Improve error messages when encountering invalid functional utility names (#18568)
Discard CSS AST objects with false or undefined properties (#18571)
Allow users to disable URL rebasing in @tailwindcss/postcss via transformAssetUrls: false (#18321)
Fix false-positive migrations in addEventListener and JavaScript variable names (#18718)
Fix Standalone CLI showing default Bun help when run via symlink on Windows (#18723)
Read from --border-color-* theme keys in divide-* utilities for backwards compatibility (#18704)
Don't scan .hdr and .exr files for classes by default (#18734)

[4.1.11] - 2025-06-26

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

Add @tailwindcss/turbopack package to run Tailwind CSS with Next.js (20367)

Fixed

Ensure watch mode detects changes to symlinked @source files whose real paths aren't otherwise scanned (#20356)
Ensure custom variants using @scope wrap the generated utilities instead of nesting inside them (#20369)
Fix flattening of @scope at-rules (#20369)
Fix standalone declarations in @scope, wrap them in :where(:scope) (#20369)
Always emit a space for empty fallback values in CSS variables (e.g. var(--tw-blur,) → var(--tw-blur, )) (#20373)
Canonicalization: convert arbitrary breakpoint and container query variants to named equivalents (e.g. max-[64rem] → max-lg) (#20380)
Prevent @tailwindcss/vite from crashing on every edit under Vite's experimental bundledDev mode (#20379)
Ensure @tailwindcss/oxide falls back to WASM on platforms without native bindings (#20383)
Detect classes in Ruby percent literals using angle brackets or custom delimiters (e.g. %w<flex>, %w|flex|), including in Slim and Haml templates (#20387)
Preserve whitespace in --default(…) values in custom functional utilities (e.g. --default(box alphabetic) no longer becomes boxalphabetic) (#20392)
Don't scan gitignored directories (e.g. node_modules and .git) when the project uses a safelist-style .gitignore (e.g. /* followed by !/… negations) (#20397)
Ensure root theme('…') namespace lookups in JavaScript plugins and config files return the full namespace object instead of the value of its DEFAULT key (#20399)
Skip ignored directories entirely when computing watch globs (scanner.globs), instead of walking their full contents on every rebuild (#20408)
Oxide: drop invalid UTF-8 candidates (#20389)
@tailwindcss/vite no longer forces a full page reload for external files (e.g.: .php files) (#20414)
Canonicalization: don't merge utilities that reference different theme variables set to CSS-wide keywords like unset (#20417)
Don't generate utilities when a modifier is used that would otherwise be silently ignored (e.g. rounded-sm/[5], shadow-sm/foo, stroke-2/50) (#20419)
Only normalize top-level and, or, and not keywords in supports-[…] variants (e.g. selector(a: not (.foo)) → selector(a:not(.foo))) (#20420)
Don't warn about Angular's ::ng-deep and :host-context() when optimizing CSS (#20434)
Don't generate CSS for candidates containing an empty additional modifier (e.g. bg-red-500/50/ and group-hover/foo//bar:flex) (#20466)
Sort min-*, max-*, and container query variants with decimal values numerically (e.g. min-[40.25rem] before min-[40.5rem]) (#20512)
Ensure CSS comments ending with \*/ are closed correctly instead of swallowing the CSS that follows (e.g. /* C:\temp\*/) (#20508)
Improve style invalidation performance of group-* and peer-* variants (#20513)
Ensure cached compilers don't keep loadModule and loadStylesheet callbacks alive after compilation (#20531)
Canonicalization: keep the & when moving a pseudo-element into * or ** (e.g. [&_::before]:flex → **:[&::before]:flex) (#20550)
Fix Set.prototype.intersection polyfill in canonicalizeCandidates(…) on Node.js < 22, which returned the first set instead of the intersection (#20562)
Canonicalization: fix inline theme(…) alphas with more than 2 decimals being migrated to a modifier that changes the opacity by a factor of 100 (e.g. theme(colors.red.500/.12345) → text-red-500/[12.345%], not text-red-500/[12.345]) (#20563)
Canonicalization: keep inline theme(…) alphas as an arbitrary percentage when a custom --opacity-* theme value would change the opacity (e.g. theme(colors.red.500/50%) → text-red-500/[50%] with --opacity-50: 10%) (#20563)

[4.3.3] - 2026-07-16

Fixed

Support --watch --poll[=ms] in @tailwindcss/cli when filesystem events are unreliable or unavailable (#20297)
Canonicalization: match arbitrary hex colors against theme colors case-insensitively (e.g. bg-[#fff] and bg-[#FFF] → bg-white) (#20298)
Prevent Preflight from overriding Firefox's native iframe:focus-visible outline styles (#20292)
Ensure theme('colors.foo') in JS plugins resolves correctly when both --color-foo and --color-foo-bar exist (#20299)
Ensure fractional opacity modifiers work with named shadow sizes like shadow-sm/12.5, text-shadow-sm/12.5, drop-shadow-sm/12.5, and inset-shadow-sm/12.5 (#20302)
Parse selectors like [data-foo]div as two selectors instead of one (#20303)
Ensure @tailwindcss/postcss rebuilds when a preprocessor like Sass changes the input CSS without changing the input file on disk (#20310)
Ensure CSS nesting is handled even when Lightning CSS isn't run, such as in @tailwindcss/browser and Tailwind Play (#20124)
Prevent achromatic theme colors from shifting hue when mixed in polar color spaces like oklch (#20314)
Ensure --spacing(0) is optimized to 0px instead of 0 so it remains a <length> when used in calc(…) (#20319)
Load @parcel/watcher only when needed in @tailwindcss/cli --watch mode, so one-off builds and --watch --poll work when @parcel/watcher can't be loaded (#20325)
Use explicit platform fonts instead of system-ui and ui-sans-serif so CJK text respects the page's lang attribute on Windows (#20318)
Prevent @tailwindcss/upgrade from rewriting ignored files when run from a subdirectory (#20329)
Ensure earlier @source rules pointing to nested files are scanned when later @source rules point to files in parent folders (#20335)
Prevent @tailwindcss/vite from triggering full page reloads when scanned files are processed by Vite but haven't been loaded as modules yet (#20336)

[4.3.2] - 2026-06-26

Fixed

Support bare spacing values for auto-rows-* and auto-cols-* utilities (e.g. auto-rows-12 and auto-cols-16) (#20229)
Prevent @tailwindcss/cli in --watch mode from crashing on Windows when @source points to a directory that doesn't exist (#20242)
Prevent @tailwindcss/vite from crashing in Deno v2.8.x when context.parentURL is not a valid URL (#20245)
Ensure @tailwindcss/cli in --watch mode rebuilds when the input CSS file changes in an ignored directory (#20246)
Allow @variant rules used in addBase(…) to use custom variants defined later (#20247)
Prevent @tailwindcss/vite from crashing during HMR when scanned files or directories are deleted (#20259)
Generate font-size instead of color declarations for text-[--spacing(…)] (#20260)
Prevent @source patterns from scanning unrelated sibling files and folders (#20263)
Extract class candidates adjacent to Template Toolkit delimiters like %]…[% in .tt, .tt2, and .tx files (#20269)
Extract class candidates from conditional Maud syntax like p.text-black[condition] (#20269)
Prevent @position-try rules from triggering unknown at-rule warnings when optimizing CSS (#20277)
Support class suggestions for named opacity modifiers from --opacity theme values (#20287)
Prevent type errors in @tailwindcss/postcss when used with newer PostCSS patch releases (#20289)

[4.3.1] - 2026-06-12

Added

Add --silent option to suppress output in @tailwindcss/cli (#20100)

Fixed

Remove deprecation warnings by using Module#registerHooks instead of Module#register on Node 26+ (#20028)
Canonicalization: don't crash when plugin utilities throw for unsupported values (#20052)
Allow @apply to be used with CSS mixins (#19427)
Ensure not-* correctly negates @container queries, including style(…) queries (#20059)
Ensure drop-shadow-* color utilities work with custom shadow values containing calc(…) (#20080)
Fix 'Sourcemap is likely to be incorrect' warnings when using @tailwindcss/vite (#20103)
Ensure @tailwindcss/webpack can be installed in Rspack projects without requiring webpack as a peer dependency (#20027)
Canonicalization: don't suggest invalid calc(…) expressions (e.g. px-[calc(1rem+0px)] → px-[calc(1rem+0)]) (#20127)
Canonicalization: avoid suggesting large spacing-scale values for arbitrary lengths (e.g. left-[99999px] → left-[99999px], not left-24999.75) (#20130)
Ensure @tailwindcss/cli in --watch mode recovers when a tracked dependency is deleted and restored (#20137)
Ensure standalone @tailwindcss/cli binaries are ignored when scanning for class candidates (#20139)
Ensure class candidates are extracted from Twig addClass(…) and removeClass(…) calls (#20198)
Don't crash in the Ruby or Vue preprocessors when scanning files containing invalid UTF-8 bytes (#19588)
Allow @variant to be used inside addBase (#19480)
Ensure @source globs with symlinks are preserved (#20203)
Ensure later @source rules can re-include files excluded by earlier @source not rules (#20203)
Upgrade: don't migrate empty class rules to invalid @utility rules (#20205)
Ensure transitions between inset-shadow-none and other inset shadows work correctly (#20208)
Ensure explicitly referenced @source directories are scanned even when ignored by git (#20214)
Ensure @source globs ending in **/* preserve dynamic path segments to avoid scanning too many files (#20217)
Canonicalization: don't fold calc(…) divisions when the result would require high precision (e.g. w-[calc(100%/3.5)] → w-[calc(100%/3.5)], not w-[28.571428571428573%]) (#20221)
Serve ESM type declarations to ESM importers of @tailwindcss/postcss (#20228)

Changed

Generate 0 instead of calc(var(--spacing) * 0) for spacing utilities like m-0 and left-0 (#20196)
Generate var(--spacing) instead of calc(var(--spacing) * 1) for spacing utilities like m-1 and left-1 (#20196)

[4.3.0] - 2026-05-08

Added

Add @container-size utility (#18901)
Add scrollbar-{auto,thin,none} utilities for scrollbar-width, and scrollbar-thumb-* / scrollbar-track-* color utilities for scrollbar-color (#19981, #20019)
Add scrollbar-gutter-* utilities (#20018)
Add zoom-* utilities (#20020)
Add tab-* utilities (#20022)
Allow using @variant with stacked variants (e.g. @variant hover:focus { … }) (#19996)
Allow using @variant with compound variants (e.g. @variant hover, focus { … }) (#19996)
Support --default(…) in --value(…) and --modifier(…) for functional @utility definitions (#19989)

Fixed

Ensure @plugin resolves package JavaScript entries instead of browser CSS entries when using @tailwindcss/vite (#19949)
Fix relative @import and @plugin paths resolving from the wrong directory when using @tailwindcss/vite (#19965)
Ensure CSS files containing @variant are processed by @tailwindcss/vite (#19966)
Resolve imports relative to base when result.opts.from is not provided when using @tailwindcss/postcss (#19980)
Canonicalization: preserve significant _ whitespace in arbitrary values (#19986)
Canonicalization: add parentheses when removing whitespace from arbitrary values would hurt readability (e.g. w-[calc(100%---spacing(60))] → w-[calc(100%-(--spacing(60)))]) (#19986)
Canonicalization: preserve the original unit in arbitrary values instead of normalizing to base units (e.g. -mt-[20in] → mt-[-20in], not mt-[-1920px]) (#19988)
Canonicalization: migrate arbitrary :has() variants from [&:has(…)] to has-[…] (#19991)
Upgrade: don’t migrate inline style attributes (e.g. style="flex-grow: 1" → style="flex-grow: 1", not style="grow: 1") (#19918)
Allow multiple @utility definitions with the same name but different value types (#19777)
Export missing PluginWithConfig type from tailwindcss/plugin to fix errors when inferring plugin config types (#19707)
Ensure start and end legacy utilities without values do not generate CSS (#20003)
Ensure --value(…) is required in functional @utility definitions (#20005)
Canonicalization: preserve required whitespace around operators in negated arbitrary values (e.g. -left-[(var(--a)+var(--b))]) (#20011)

[4.2.4] - 2026-04-21

Fixed

Ensure imports in @import and @plugin still resolve correctly when using Vite aliases in @tailwindcss/vite (#19947)

[4.2.3] - 2026-04-20

Fixed

Canonicalization: improve canonicalization for tracking-* utilities by preferring non-negative utilities (e.g. -tracking-tighter → tracking-wider) (#19827)
Fix crash due to invalid characters in candidate (exceeding valid unicode code point range) (#19829)
Ensure query params in imports are considered unique resources when using @tailwindcss/webpack (#19723)
Canonicalization: collapse arbitrary values into shorthand utilities (e.g. px-[1.2rem] py-[1.2rem] → p-[1.2rem]) (#19837)
Canonicalization: collapse border-{t,b}-* into border-y-*, border-{l,r}-* into border-x-*, and border-{t,r,b,l}-* into border-* (#19842)
Canonicalization: collapse scroll-m{t,b}-* into scroll-my-*, scroll-m{l,r}-* into scroll-mx-*, and scroll-m{t,r,b,l}-* into scroll-m-* (#19842)
Canonicalization: collapse scroll-p{t,b}-* into scroll-py-*, scroll-p{l,r}-* into scroll-px-*, and scroll-p{t,r,b,l}-* into scroll-p-* (#19842)
Canonicalization: collapse overflow-{x,y}-* into overflow-* (#19842)
Canonicalization: collapse overscroll-{x,y}-* into overscroll-* (#19842)
Read from --placeholder-color instead of --background-color for placeholder-* utilities (#19843)
Upgrade: ensure files are not emptied out when killing the upgrade process while it's running (#19846)
Upgrade: use config.content when migrating from Tailwind CSS v3 to Tailwind CSS v4 (#19846)
Upgrade: never migrate files that are ignored by git (#19846)
Add .env and .env.* to default ignored content files (#19846)
Canonicalization: migrate overflow-ellipsis into text-ellipsis (#19849)
Canonicalization: migrate start-full → inset-s-full, start-auto → inset-s-auto, start-px → inset-s-px, and start-<number> → inset-s-<number> as well as negative versions (#19849)
Canonicalization: migrate end-full → inset-e-full, end-auto → inset-e-auto, end-px → inset-e-px, and end-<number> → inset-e-<number> as well as negative versions (#19849)
Canonicalization: move the - sign inside the arbitrary value -left-[9rem] → left-[-9rem] (#19858)
Canonicalization: move the - sign outside the arbitrary value ml-[calc(-1*var(--width))] → -ml-(--width) (#19858)
Improve performance when scanning JSONL / NDJSON files (#19862)
Support NODE_PATH environment variable in standalone CLI (#19617)

[4.2.2] - 2026-03-18

Fixed

Don't crash when candidates contain prototype properties like row-constructor (#19725)
Canonicalize calc(var(--spacing)*…) expressions into --spacing(…) (#19769)
Fix crash in canonicalization step when handling utilities containing @property at-rules (e.g. shadow-sm border) (#19727)
Skip full reload for server only modules scanned by client CSS when using @tailwindcss/vite (#19745)
Add support for Vite 8 in @tailwindcss/vite (#19790)
Improve canonicalization for bare values exceeding default spacing scale suggestions (e.g. w-1234 h-1234 → size-1234) (#19809)
Fix canonicalization resulting in empty list (e.g. w-5 h-5 size-5 → '' instead of size-5) (#19812)
Resolve tsconfig paths to allow for @import '@/path/to/file'; when using @tailwindcss/vite (#19803)

[4.2.1] - 2026-02-23

Fixed

Allow trailing dash in functional utility names for backwards compatibility (#19696)
Properly detect classes containing . characters within curly braces in MDX files (#19711)

[4.2.0] - 2026-02-18

Added

Add mauve, olive, mist, and taupe color palettes to the default theme (#19627)
Add @tailwindcss/webpack package to run Tailwind CSS as a webpack plugin (#19610)
Add pbs-* and pbe-* utilities for padding-block-start and padding-block-end (#19601)
Add mbs-* and mbe-* utilities for margin-block-start and margin-block-end (#19601)
Add scroll-pbs-* and scroll-pbe-* utilities for scroll-padding-block-start and scroll-padding-block-end (#19601)
Add scroll-mbs-* and scroll-mbe-* utilities for scroll-margin-block-start and scroll-margin-block-end (#19601)
Add border-bs-* and border-be-* utilities for border-block-start and border-block-end (#19601)
Add inline-*, min-inline-*, max-inline-* utilities for inline-size, min-inline-size, and max-inline-size (#19612)
Add block-*, min-block-*, max-block-* utilities for block-size, min-block-size, and max-block-size (#19612)
Add inset-s-*, inset-e-*, inset-bs-*, inset-be-* utilities for inset-inline-start, inset-inline-end, inset-block-start, and inset-block-end (#19613)
Add font-features-* utility for font-feature-settings (#19623)

Fixed

Prevent double @supports wrapper for color-mix values (#19450)
Allow whitespace around @source inline() argument (#19461)
Emit comment when source maps are saved to files when using @tailwindcss/cli (#19447)
Detect utilities containing capital letters followed by numbers (#19465)
Fix class extraction for Rails' strict locals (#19525)
Align @utility name validation with Oxide scanner rules (#19524)
Fix infinite loop when using @variant inside @custom-variant (#19633)
Allow multiples of .25 in aspect-* fractions (e.g. aspect-8.5/11) (#19688)
Ensure changes to external files listed via @source trigger a full page reload when using @tailwindcss/vite (#19670)
Improve performance of Oxide scanner in bigger projects by reducing file system walks (#19632)
Ensure import aliases in Astro v5 work without crashing when using @tailwindcss/vite (#19677)
Allow escape characters in @utility names to improve support with formatters such as Biome (#19626)
Fix incorrect canonicalization results when canonicalizing multiple times (#19675)
Add .jj to default ignored content directories (#19687)

Deprecated

Deprecate start-* and end-* utilities in favor of inset-s-* and inset-e-* utilities (#19613)

[4.1.18] - 2025-12-11

Fixed

Ensure validation of source(…) happens relative to the file it is in (#19274)
Include filename and line numbers in CSS parse errors (#19282)
Skip comments in Ruby files when checking for class names (#19243)
Skip over arbitrary property utilities with a top-level ! in the value (#19243)
Support environment API in @tailwindcss/vite (#18970)
Preserve case of theme keys from JS configs and plugins (#19337)
Write source maps correctly on the CLI when using --watch (#19373)
Handle special defaults (like ringColor.DEFAULT) in JS configs (#19348)
Improve backwards compatibility for content theme key from JS configs (#19381)
Upgrade: Handle future and experimental config keys (#19344)
Try to canonicalize any arbitrary utility to a bare value (#19379)
Validate candidates similarly to Oxide (#19397)
Canonicalization: combine text-* and leading-* classes (#19396)
Correctly handle duplicate CLI arguments (#19416)
Don’t emit color-mix fallback rules inside @keyframes (#19419)
CLI: Don't hang when output is /dev/stdout (#19421)

[3.4.19] - 2025-12-10

Fixed

Don’t break sibling-*() functions when used inside calc(…) (#19335)

[4.1.17] - 2025-11-06

Fixed

Substitute @variant inside legacy JS APIs (#19263)
Prevent occasional crash on Windows when loaded into a worker thread (#19242)

[4.1.16] - 2025-10-23

Fixed

Discard candidates with an empty data type (#19172)
Fix canonicalization of arbitrary variants with attribute selectors (#19176)
Fix invalid colors due to nested & (#19184)
Improve canonicalization for & > :pseudo and & :pseudo arbitrary variants (#19178)

[4.1.15] - 2025-10-20

Fixed

Fix Safari devtools rendering issue due to color-mix fallback (#19069)
Suppress Lightning CSS warnings about :deep, :slotted, and :global (#19094)
Fix resolving theme keys when starting with the name of another theme key in JS configs and plugins (#19097)
Allow named groups in combination with not-*, has-*, and in-* (#19100)
Prevent important utilities from affecting other utilities (#19110)
Don’t index into strings with the theme(…) function (#19111)
Fix parsing issue when \t is used in at-rules (#19130)
Upgrade: Canonicalize utilities containing 0 values (#19095)
Upgrade: Migrate deprecated break-words to wrap-break-word (#19157)

Changed

Remove the postinstall script from oxide ([#19149])(https://github.com/tailwindlabs/tailwindcss/pull/19149)

[4.1.14] - 2025-10-01

Fixed

Handle ' syntax in ClojureScript when extracting classes (#18888)
Handle @variant inside @custom-variant (#18885)
Merge suggestions when using @utility (#18900)
Ensure that file system watchers created when using the CLI are always cleaned up (#18905)
Do not generate grid-column utilities when configuring grid-column-start or grid-column-end (#18907)
Do not generate grid-row utilities when configuring grid-row-start or grid-row-end (#18907)
Prevent duplicate CSS when overwriting a static utility with a theme key (#18056)
Show Lightning CSS warnings (if any) when optimizing/minifying (#18918)
Use default export condition for @tailwindcss/vite (#18948)
Re-throw errors from PostCSS nodes (#18373)
Detect classes in markdown inline directives (#18967)
Ensure files with only @theme produce no output when built (#18979)
Support Maud templates when extracting classes (#18988)
Upgrade: Do not migrate variant = 'outline' during upgrades (#18922)
Upgrade: Show version mismatch (if any) when running upgrade tool (#19028)
Upgrade: Ensure first class inside className is migrated (#19031)
Upgrade: Migrate classes inside *ClassName and *Class attributes (#19031)

[3.4.18] - 2025-10-01

Fixed

Improve support for raw supports-[…] queries in arbitrary values (#13605)
Fix require.cache error when loaded through a TypeScript file in Node 22.18+ (#18665)
Support import.meta.resolve(…) in configs for new enough Node.js versions (#18938)
Allow using newer versions of postcss-load-config for better ESM and TypeScript PostCSS config support with the CLI (#18938)
Remove irrelevant utility rules when matching important classes (#19030)

[4.1.13] - 2025-09-03

Changed

Drop warning from browser build (#18731)
Drop exact duplicate declarations when emitting CSS (#18809)

Fixed

Don't transition visibility when using transition (#18795)
Discard matched variants with unknown named values (#18799)
Discard matched variants with non-string values (#18799)
Show suggestions for known matchVariant values (#18798)
Replace deprecated clip with clip-path in sr-only (#18769)
Hide internal fields from completions in matchUtilities (#18820)
Ignore .vercel folders by default (can be overridden by @source … rules) (#18855)
Consider variants starting with @- to be invalid (e.g. @-2xl:flex) (#18869)
Do not allow custom variants to start or end with a - or _ (#18867, #18872)
Upgrade: Migrate aria theme keys to @custom-variant (#18815)
Upgrade: Migrate data theme keys to @custom-variant (#18816)
Upgrade: Migrate supports theme keys to @custom-variant (#18817)

[4.1.12] - 2025-08-13

Fixed

Don't consider the global important state in @apply (#18404)
Add missing suggestions for flex-<number> utilities (#18642)
Fix trailing ) from interfering with extraction in Clojure keywords (#18345)
Detect classes inside Elixir charlist, word list, and string sigils (#18432)
Track source locations through @plugin and @config (#18345)
Allow boolean values of process.env.DEBUG in @tailwindcss/node (#18485)
Ignore consecutive semicolons in the CSS parser (#18532)
Center the dropdown icon added to an input with a paired datalist by default (#18511)
Extract candidates in Slang templates (#18565)
Improve error messages when encountering invalid functional utility names (#18568)
Discard CSS AST objects with false or undefined properties (#18571)
Allow users to disable URL rebasing in @tailwindcss/postcss via transformAssetUrls: false (#18321)
Fix false-positive migrations in addEventListener and JavaScript variable names (#18718)
Fix Standalone CLI showing default Bun help when run via symlink on Windows (#18723)
Read from --border-color-* theme keys in divide-* utilities for backwards compatibility (#18704)
Don't scan .hdr and .exr files for classes by default (#18734)