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)

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)

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)

Fixed

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

Fixed

• Canonicalization: improve canonicalizations 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)

Added

• Support Vite 8 in @tailwindcss/vite (#19790)

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)
• 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)

Fixed

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

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)

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)

Fixed

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

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)

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)

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)

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)

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)

Fixed

• Add heuristic to skip candidate migrations inside emit(…) (#18330)
• Extract candidates with variants in Clojure/ClojureScript keywords (#18338)
• Document --watch=always in the CLI's usage (#18337)
• Add support for Vite 7 to @tailwindcss/vite (#18384)

Fixed

• Fix incorrectly generated CSS when using percentages in arbitrary values with calc (e.g. w-[calc(100%-var(--offset))]) (#18289)

Fixed

• Correctly parse custom properties with strings containing semicolons (#18251)
• Upgrade: Migrate arbitrary modifiers without percentage signs to bare values (e.g. /[0.16] → /16) (#18184)
• Upgrade: Migrate CSS variable shorthands where fallback value contains function call (#18184)
• Upgrade: Migrate negative arbitrary values to negative bare values (e.g. mb-[-32rem] → -mb-128) (#18212)
• Upgrade: Do not migrate blur in wire:model.blur (#18216)
• Don't add spaces around CSS dashed idents when formatting math expressions (#18220)

Added

• Improve error messages when @apply fails (#18059)

Fixed

• Upgrade: Do not migrate declarations that look like candidates in <style> blocks (#18057, 18068)
• Upgrade: Don't error when looking for tailwindcss in pnpm monorepos (#18065)
• Upgrade: Don't error when updating dependencies in pnpm monorepos (#18065)
• Upgrade: Migrate deprecated order-none to order-0 (#18126)
• Support Leptos class: attributes when extracting classes (#18093)
• Fix "Cannot read properties of undefined" crash on malformed arbitrary value (#18133)
• Upgrade: Migrate -mt-[0px] to mt-[0px] instead of the other way around (#18154)
• Fix Haml pre-processing crash when there is no \n at the end of the file (#18155)
• Ignore .pnpm-store folders by default (can be overridden by @source … rules) (#18163)
• Fix PostCSS crash when calling toJSON() (#18083)

Added

• Upgrade: Migrate bare values to named values (#18000)
• Upgrade: Added cache to improve template migration performance (#18025)

Fixed

• Allow _ before numbers during candidate extraction (#17961)
• Prevent duplicate suggestions when using @theme and @utility together (#17675)
• Ensure that media queries within ::before and ::after pseudo selectors create valid CSS rules in production builds (#17979)
• Ensure that the standalone CLI does not leave temporary files behind (#17981)
• Ensure -rotate-* utilities properly negate arbitrary values (#18014)
• Ignore custom variants using :merge(…) selectors in legacy JS plugins (#18020)
• Ensure classes containing . are properly extracted from Clojure files (#18038)
• Upgrade: Fix error when using @import … source(…) (#17963)
• Upgrade: Change casing of utilities with named values to kebab-case to match updated theme variables (#18017)
• Upgrade: Don't migrate strings that match utility names in Vue attribute bindings other than class (#18025)

Added

• Upgrade: Automatically convert arbitrary values to named values when possible (e.g. h-[1lh] to h-lh) (#17831, #17854)
• Upgrade: Update dependencies in parallel for improved performance (#17898)
• Add detailed logging about @source directives, discovered files and scanned files when using DEBUG=* (#17906, #17952)
• Add support for generating source maps in development (#17775)

Fixed

• Ensure negative arbitrary scale values generate negative values (#17831)
• Fix HAML extraction with embedded Ruby (#17846)
• Don't scan files for utilities when using @reference (#17836)
• Fix incorrectly replacing _ with in arbitrary modifier shorthand bg-red-500/(--my_opacity) (#17889)
• Don't scan .log files for classes by default (#17906)
• Ensure that custom utilities applying other custom utilities don't swallow nested @apply rules (#17925)
• Download platform specific package if optionalDependencies are skipped (#17929)

Added

• Support using @tailwindcss/upgrade to upgrade between versions of v4.* (#17717)
• Add h-lh / min-h-lh / max-h-lh utilities (#17790)
• Transition display, visibility, content-visibility, overlay, and pointer-events when using transition to simplify @starting-style usage (#17812)

Fixed

• Don't scan .geojson or .db files for classes by default (#17700, #17711)
• Hide default shadow suggestions when missing default shadow theme keys (#17743)
• Replace _ with . in theme suggestions for @utility if surrounded by digits (#17733)
• Skip color-mix(…) when opacity is 100% (#17815)
• PostCSS: Ensure that errors in imported stylesheets are recoverable (#17754)
• Upgrade: Bump all Tailwind CSS related dependencies during upgrade (#17763)
• Upgrade: Don't add - to variants starting with @ (#17814)
• Upgrade: Don't format stylesheets that didn't change when upgrading (#17824)

Added

• Add experimental @tailwindcss/oxide-wasm32-wasi target for running Tailwind in browser environments like StackBlitz (#17558)

Fixed

• Ensure color-mix(…) polyfills do not cause used CSS variables to be removed (#17555)
• Ensure color-mix(…) polyfills create fallbacks for theme variables that reference other theme variables (#17562)
• Fix brace expansion in declining ranges like {10..0..5} and {0..10..-5} (#17591)
• Work around a Chrome rendering bug when using the skew-* utilities (#17627)
• Ensure container query variant names can contain hyphens (#17628)
• Ensure shadow-inherit, inset-shadow-inherit, drop-shadow-inherit, and text-shadow-inherit inherit the shadow color (#17647)
• Ensure compatibility with array tuples used in fontSize JS theme keys (#17630)
• Ensure folders with binary file extensions in their names are scanned for utilities (#17595)
• Upgrade: Convert fontSize array tuple syntax to CSS theme variables (#17630)

Fixed

• Show warning when using unsupported bare value data type in --value(…) (#17464)
• PostCSS: Ensure changes to the input CSS file don't generate stale output when using Turbopack (#17554)
• Ensure classes are detected in Ruby's %w syntax in Slim templates (#17557)

Fixed

• Don't rely on the presence of @layer base to polyfill @property (#17506)
• Support setting multiple inset shadows as arbitrary values (#17523)
• Fix drop-shadow-* utilities that are defined with multiple shadows (#17515)
• PostCSS: Fix race condition when two changes are queued concurrently (#17514)
• PostCSS: Ensure files containing @tailwind utilities are processed (#17514)
• Ensure the color-mix(…) polyfill creates fallbacks even when using colors that cannot be statically analyzed (#17513)
• Fix slow incremental builds with @tailwindcss/vite and @tailwindcss/postscss (especially on Windows) (#17511)
• Vite: Fix missing CSS file in Qwik setups (#17533)

Fixed

• Disable padding in @source inline(…) brace expansion (#17491)
• Inject polyfills after @import and body-less @layer (#17493)
• Ensure @tailwindcss/cli does not contain an import for jiti (#17502)

Added

• Add details-content variant (#15319)
• Add inverted-colors variant (#11693)
• Add noscript variant (#11929, #17431)
• Add items-baseline-last and self-baseline-last utilities (#13888, #17476)
• Add pointer-none, pointer-coarse, and pointer-fine variants (#16946)
• Add any-pointer-none, any-pointer-coarse, and any-pointer-fine variants (#16941)
• Add safe alignment utilities (#14607)
• Add user-valid and user-invalid variants (#12370)
• Add wrap-anywhere, wrap-break-word, and wrap-normal utilities (#12128)
• Add @source inline(…) and @source not inline(…) (#17147)
• Add @source not "…" (#17255)
• Add text-shadow-* utilities (#17389)
• Add mask-* utilities (#17134)
• Add bg-{position,size}-* utilities for arbitrary values (#17432)
• Add shadow-*/<alpha>, inset-shadow-*/<alpha>, drop-shadow-*/<alpha>, and text-shadow-*/<alpha> utilities to control shadow opacity (#17398, #17434)
• Add drop-shadow-<color> utilities (#17434)
• Improve compatibility with older versions of Safari and Firefox (#17435)

Fixed

• Follow symlinks when resolving @source directives (#17391)
• Don't scan ignored files for classes when changing an ignored file triggers a rebuild using @tailwindcss/cli (#17255)
• Support negated content rules in legacy JavaScript configuration (#17255)
• Interpret syntax like @("@")md:… as @md:… in Razor files (#17427)
• Disallow top-level braces, top-level semicolons, and unbalanced parentheses and brackets in arbitrary values (#17361)
• Ensure the --theme(…) function still resolves to the CSS variables when using legacy JS plugins (#17458)
• Detect used theme variables in CSS module files (#17433, #17467)

Changed

• Ignore node_modules by default (can be overridden by @source … rules) (#17255)
• @source rules that include file extensions or point inside node_modules/ folders no longer consider your .gitignore rules (#17255)
• Deprecate bg-{left,right}-{top,bottom} in favor of bg-{top,bottom}-{left,right} utilities (#17378)
• Deprecate object-{left,right}-{top,bottom} in favor of object-{top,bottom}-{left,right} utilities (#17437)

Fixed

• Fix an issue causing the CLI to hang when processing Ruby files (#17383)

Added

• Add support for literal values in --value('…') and --modifier('…') (#17304)

Fixed

• Fix class extraction followed by ( in Pug (#17320)
• Ensure @keyframes for theme animations are emitted if they are referenced following a comma (#17352)
• Vite: Ensure that updates to an imported CSS file are properly propagated after updating source files (#17347)
• Pre process Slim templates embedded in Ruby files (#17336)
• Error when input and output files resolve to the same file when using the CLI (#17311)
• Add missing suggestions when --spacing(--value(integer, number)) is used (#17308)
• Add ::-webkit-details-marker pseudo to marker variant (#17362)

Fixed

• Fix incorrect angle in -bg-conic-* utilities (#17174)
• Fix border-[12px_4px] being interpreted as a border-color instead of a border-width (#17248)
• Work around a crash in Safari 16.4 and 16.5 when using the default Preflight styles (#17306)
• Pre-process <template lang="…"> in Vue files (#17252)
• Ensure that all CSS variables used by Preflight are prefixed (#17036)
• Prevent segfault when loaded in a worker thread on Linux (#17276)
• Ensure multiple --value(…) or --modifier(…) calls don't delete subsequent declarations (#17273)
• Fix class extraction followed by ( in Slim (#17278)
• Export PluginUtils from tailwindcss/plugin for compatibility with v3 (#17299)
• Remove redundant line-height: initial from Preflight (#15212)
• Increase Standalone hardware compatibility on macOS x64 builds (#17267)
• Ensure that the CSS file rebuilds if a new CSS variable is used from templates (#17301)

Changed

• The --theme(…) function now returns CSS variables from your theme variables unless used inside positions where CSS variables are invalid (e.g. inside @media queries) (#17036)

Fixed

• Do not extract candidates with JS string interpolation ${ (#17142)
• Fix extraction of variants containing . character (#17153)
• Fix extracting candidates in Clojure/ClojureScript (#17087)

Fixed

• Fix Haml pre-processing (#17051)
• Ensure .node and .wasm files are not scanned for utilities (#17123)
• Improve performance when scanning JSON files (#17125)
• Fix extracting candidates containing dots in Haml, Pug, and Slim pre processors (#17094, #17085, #17113)
• Don't create invalid CSS when encountering a link wrapped in square brackets (#17129)

Fixed

• Vite: Fix url(…) rebasing in transitively imported CSS files (#16965)
• PostCSS: Rebase url(…)s in imported CSS files (#16965)
• Ensure utilities are sorted based on their actual property order (#16995)
• Ensure strings in Pug and Slim templates are handled correctly (#17000)
• Ensure classes between } and { are properly extracted (#17001)
• Fix razor/cshtml pre-processing (#17027)
• Ensure extracting candidates from JS embedded in a PHP string works as expected (#17031)

Fixed

• Ensure classes containing -- are extracted correctly (#16972)
• Ensure classes containing numbers followed by dash or underscore are extracted correctly (#16980)
• Ensure arbitrary container queries are extracted correctly (#16984)
• Ensure classes ending in [ are extracted in Slim templating language (#16985)
• Ensure arbitrary variables with data types are extracted correctly (#16986)

Added

• Add col-<number> and row-<number> utilities for grid-column and grid-row (#15183)

Fixed

• Ensure not-* does not remove :is(…) from variants (#16825)
• Ensure @keyframes are correctly emitted when using a prefix (#16850)
• Don't swallow @utility declarations when @apply is used in nested rules (#16940)
• Ensure outline-hidden behaves like outline-none outside of forced colors mode (#16943)
• Allow !important on CSS variables again (#16873)
• Vite: Do not crash when encountering an .svg file with # or ? in the filename (#16957)
• Ensure utilities are properly detected within square brackets (#16306)
• Ensure utilities are properly detected using Angular's conditional class binding syntax (#16306)
• Ensure utilities starting with numbers are properly extracted from Slim templates (#16306)
• Discard arbitrary property candidates that have guaranteed-invalid property names (#16306)

Changed

• Removed max-w-auto and max-h-auto utilities as they generate invalid CSS (#16917)
• Replaced the existing candidate extractor with a brand new extractor to improve maintainability, correctness, and performance (#16306)

Fixed

• Make JS APIs available to plugins and configs in the Standalone CLI (#15934)
• Vite: Don't crash when importing a virtual module from JavaScript that ends in .css (#16780)
• Fix an issue where @reference "…" would sometimes omit keyframe animations (#16774)
• Ensure z-*! utilities are properly marked as !important (#16795)
• Read UTF-8 CSS files that start with a byte-order mark (BOM) (#16800)
• Ensure nested functions in selectors used with JavaScript plugins are not truncated (#16802)

Changed

• Emit variable fallbacks when using @reference "…" instead of duplicate CSS variable declarations (#16774)

Added

• Allow @import with theme(…) options for stylesheets that contain more than just @theme rules (#16514)

Fixed

• Don't add !important to CSS variable declarations when using the important modifier (#16668)
• Vite: Ignore files and directories specified in your .gitignore file when using automatic source detection(#16631)
• Vite: Don't rely on the module graph for detecting candidates to ensure setups with multiple Vite builds work as expected (#16631)
• Vite: Ensure Astro production builds always contain classes used in client-only components (#16631)
• Vite: Always scan raw file contents for utility classes before any other transforms have been applied to ensure utility classes are scanned without any additional escaping (#16631)
• Ensure utilities with more declarations are always sorted before utilities with fewer declarations when utilities only define CSS variables (#16715)
• Only include translate-z-px utilities once in compiled CSS (#16718)

Changed

• Don't include theme variables that aren't used in compiled CSS (#16211, #16676)

Fixed

• Export tailwindcss/lib/util/flattenColorPalette.js for backward compatibility (#16411)
• Fix sorting of numeric utility suggestions when they have different magnitudes (#16414)
• Show suggestions for fractions in IntelliSense (#16353)
• Don’t replace _ in suggested theme keys (#16433)
• Ensure --default-outline-width can be used to change the outline-width value of the outline utility (#16469)
• Ensure drop shadow utilities don't inherit unexpectedly (#16471)
• Export config and plugin types from tailwindcss/plugin for backward compatibility (#16505)
• Ensure JavaScript plugins that emit nested rules referencing the utility name work as expected (#16539)
• Statically link Visual Studio redistributables in @tailwindcss/oxide Windows builds (#16602)
• Ensure that Next.js splat routes are scanned for classes (#16457)
• Pin exact version of tailwindcss in @tailwindcss/* packages (#16623)
• Upgrade: Report errors when updating dependencies (#16504)
• Upgrade: Ensure a darkMode JS config setting with block syntax converts to use @slot (#16507)
• Upgrade: Ensure the latest version of tailwindcss and @tailwindcss/postcss are installed when upgrading (#16620)

Fixed

• Revert change to no longer include theme variables that aren't used in compiled CSS (#16403)

Added

• Add @theme static option for always including theme variables in compiled CSS (#16211)

Fixed

• Remove rogue console.log from @tailwindcss/vite (#16307)

Changed

• Don't include theme variables that aren't used in compiled CSS (#16211)

Fixed

• Fix a crash when setting JS theme values to null (#16210)
• Ensure escaped underscores in CSS variables in arbitrary values are properly unescaped (#16206)
• Ensure that the containers JS theme key is added to the --container-* namespace (#16169)
• Ensure theme @keyframes are generated even if an --animation-* variable spans multiple lines (#16237)
• Vite: Skip parsing stylesheets with the ?commonjs-proxy flag (#16238)
• Fix order-first and order-last for Firefox (#16266)
• Fix support for older instruction sets on Linux x64 builds of the standalone CLI (#16244)
• Ensure NODE_PATH is respected when resolving JavaScript and CSS files (#16274)
• Ensure Node addons are packaged correctly with FreeBSD builds (#16277)
• Fix an issue where @variant inside a referenced stylesheet could cause a stack overflow (#16300)

Fixed

• Fix incorrect removal of @import url(); (#16144)

Fixed

• Only generate positive grid-cols-* and grid-rows-* utilities (#16020)
• Ensure escaped theme variables are handled correctly (#16064)
• Ensure we process Tailwind CSS features when only using @reference or @variant (#16057)
• Refactor gradient implementation to work around prettier/prettier#17058 (#16072)
• Vite: Ensure hot-reloading works with SolidStart setups (#16052)
• Vite: Fix a crash when starting the development server in SolidStart setups (#16052)
• Vite: Don't rebase URLs that appear to be aliases (#16078)
• Vite: Transform <style> blocks in HTML files (#16069)
• Prevent camel-casing CSS custom properties added by JavaScript plugins (#16103)
• Do not emit @keyframes in @theme reference (#16120)
• Discard invalid declarations when parsing CSS (#16093)
• Do not emit empty CSS rules and at-rules (#16121)
• Handle @variant when at the top-level of a stylesheet (#16129)

Added

• Include :open pseudo-class in existing open variant (#15349)

Fixed

• Remove invalid min-w/h-none utilities (#15845)
• Discard CSS variable shorthand utilities that don't use valid CSS variables (#15738)
• Ensure font-size utilities with none modifier have a line-height set e.g. text-sm/none (#15921)
• Ensure font-size utilities with unknown modifier don't generate CSS (#15921)
• Don’t suggest font weight utilities more than once (#15857)
• Suggest container query variants (#15857)
• Disable bare value suggestions when not using the --spacing variable (#15857)
• Ensure suggested classes are properly sorted (#15857)
• Don’t look at .gitignore files outside initialized repos (#15941)
• Find utilities when using the Svelte class shorthand syntax across multiple lines (#15974)
• Find utilities when using the Angular class shorthand syntax (#15974)
• Find utilities when using functions inside arrays (#15974)
• Ensure that @tailwindcss/browser does not pollute the global namespace (#15978)
• Ensure that tailwind-merge is not scanned when using the Vite plugin (#16005)
• Ensure CSS theme variables are available within shadow roots (#15975)
• Fix crash when project lives in the / directory (#15988)
• Ensure custom variants have a non-empty selector list (#16009)
• Upgrade: Ensure JavaScript config files on different drives are correctly migrated (#15927)
• Upgrade: Migrate leading-[1] to leading-none (#16004)
• Upgrade: Do not migrate arbitrary leading utilities to bare values (#16004)

Holy shit it's actually done — we just tagged Tailwind CSS v4.0.

Tailwind CSS v4.0 is an all-new version of the framework optimized for performance and flexibility, with a reimagined configuration and customization experience, and taking full advantage of the latest advancements the web platform has to offer.

• New high-performance engine — where full builds are up to 5x faster, and incremental builds are over 100x faster — and measured in microseconds.
• Designed for the modern web — built on cutting-edge CSS features like cascade layers, registered custom properties with @property, and color-mix().
• Simplified installation — fewer dependencies, zero configuration, and just a single line of code in your CSS file.
• First-party Vite plugin — tight integration for maximum performance and minimum configuration.
• Automatic content detection — all of your template files are discovered automatically, with no configuration required.
• Built-in import support — no additional tooling necessary to bundle multiple CSS files.
• CSS-first configuration — a reimagined developer experience where you customize and extend the framework directly in CSS instead of a JavaScript configuration file.
• CSS theme variables — all of your design tokens exposed as native CSS variables so you can access them anywhere.
• Dynamic utility values and variants — stop guessing what values exist in your spacing scale, or extending your configuration for things like basic data attributes.
• Modernized P3 color palette — a redesigned, more vivid color palette that takes full advantage of modern display technology.
• Container queries — first-class APIs for styling elements based on their container size, no plugins required.
• New 3D transform utilities — transform elements in 3D space directly in your HTML.
• Expanded gradient APIs — radial and conic gradients, interpolation modes, and more.
• @starting-style support — a new variant you can use to create enter and exit transitions, without the need for JavaScript.
• not-* variant — style an element only when it doesn't match another variant, custom selector, or media or feature query.
• Even more new utilities and variants — including support for color-scheme, field-sizing, complex shadows, inert, and more.

Start using Tailwind CSS v4.0 today by installing it in a new project, or playing with it directly in the browser on Tailwind Play.

For existing projects, we've published a comprehensive upgrade guide and built an automated upgrade tool to get you on the latest version as quickly and painlessly as possible.

For a deep-dive into everything that's new, check out the announcement post.

Added

• Add support for using @variant to use variants in your CSS (#15663)
• Include outline-color when transitioning colors (#15690)

Fixed

• Add missing main and browser fields for @tailwindcss/browser (#15594)
• Support escaping * in theme namespace syntax (e.g.: --color-\*: initial;) (#15603)
• Respect @theme options when resolving values in custom functional utilities (#15623)
• Discard invalid variants (e.g. data-checked-[selected=1]:*) (#15629)
• Ensure -outline-offset-* utilities are suggested in IntelliSense (#15646)
• Write to stdout when --output is set to - or omitted with @tailwindcss/cli (#15656)
• Prevent not-* from being used with variants that have multiple sibling rules (#15689)
• Upgrade (experimental): Pretty print --spacing(…) to prevent ambiguity (#15596)

Changed

• Use more modern --alpha(color / 50%) syntax instead of --alpha(color, 50%) (#15665)
• Rename @variant to @custom-variant (#15663)
• Change outline-hidden to set outline-style: none except in forced colors mode (#15690)

Added

• Add @tailwindcss/browser package to run Tailwind CSS in the browser (#15558)
• Add @reference "…" API as a replacement for the previous @import "…" reference option (#15565)
• Add support for defining functional utilities in CSS (#15455)
• Add new --spacing(…), --alpha(…), and --theme(…) CSS functions (#15572)
• Add musl-based Linux builds of the standalone CLI (#15567)
• Improve performance of internal AST manipulations (#15529)

Fixed

• Use the correct property value for place-content-between, place-content-around, and place-content-evenly utilities (#15440)
• Don’t detect arbitrary properties when preceded by an escape (#15456)
• Fix incorrectly named bg-round and bg-space utilities to bg-repeat-round to bg-repeat-space (#15462)
• Fix inset-shadow-* suggestions in IntelliSense (#15471)
• Only compile arbitrary values ending in ] (#15503)
• Ensure @apply rules are processed in the correct order (#15542)
• Allow negative utility names in @utility (#15573)
• Remove all @keyframes contributed by JavaScript plugins when using @reference imports (#15581)
• Upgrade (experimental): Do not extract class names from functions (e.g. shadow in filter: 'drop-shadow(…)') (#15566)
• Upgrade (experimental): Migrate theme(spacing.2) to --spacing(2) (#15579)
• Upgrade (experimental): Migrate theme(…) to --theme(…) (#15579)

Changed

• Remove --container-prose in favor of a deprecated --max-width-prose theme variable so that *-prose is only available for max-width utilities and only for backward compatibility (#15439)
• Use Vite post-processor APIs for processing Svelte <style> blocks (#15436)

Fixed

• Ensure Symbol.dispose and Symbol.asyncDispose are polyfilled (#15404)

Added

• Export tailwindcss/lib/util/flattenColorPalette for backward compatibility (#15318)
• Improve debug logs to get better insights (#15303)

Fixed

• Fix dependency related warnings when using @tailwindcss/postcss on Windows (#15321)
• Skip creating a compiler for CSS files that should not be processed (#15340)
• Fix missing shadow-none suggestion in IntelliSense (#15342)
• Optimize AST before printing for IntelliSense (#15347)
• Generate vendor prefixes for Chrome 111+ (e.g. -webkit-background-clip: text) (#15389)

Changed

• Rename --aspect-ratio-* theme key to --aspect-* (#15365)
• Derive aspect-video utility from theme (#15365)

Fixed

• Ensure @import "…" reference never generates utilities (#15307)

Added

• Parallelize parsing of individual source files (#15270)
• Add new @import "…" reference option for importing Tailwind CSS configuration details into another CSS entry point without duplicating CSS (#15228)
• Improve performance of @tailwindcss/postcss by translating between internal data structures and PostCSS nodes directly without additional parsing or stringification (#15297)

Fixed

• Ensure absolute URLs inside imported CSS files are not rebased when using @tailwindcss/vite (#15275)
• Fix issues with dev servers using Svelte 5 with @tailwindcss/vite (#15274)
• Support installing @tailwindcss/vite in Vite 6 projects (#15274)
• Fix resolution of imported CSS files in SSR builds with @tailwindcss/vite (#15279)
• Ensure other plugins can run after @tailwindcss/postcss (#15273)
• Rebase URLs inside imported CSS files when using Vite with the @tailwindcss/postcss extension (#15273)
• Fix missing font family suggestions in IntelliSense (#15288)
• Fix missing @container suggestion in IntelliSense (#15288)

Fixed

• Don't scan source files for utilities unless @tailwind utilities is present in the CSS in @tailwindcss/postcss and @tailwindcss/vite (#15226)
• Skip reserializing CSS files that don't use Tailwind features in @tailwindcss/postcss and @tailwindcss/vite (#15226)
• Upgrade (experimental): Do not migrate the overflow-clip utility (#15244)
• Upgrade (experimental): Rename backdrop-blur to backdrop-blur-sm and backdrop-blur-sm to backdrop-blur-xs (#15242)

Fixed

• Ensure any necessary vendor prefixes are generated for iOS Safari, Firefox, and Chrome (#15166)
• Ensure .group and .peer are prefixed when using the prefix(…) option (#15174)
• Ensure 3D transforms render correctly in Safari (#15179)
• Ensure --spacing-* variables take precedence over --container-* variables (#15180)
• Fix scanning classes delimited by tab characters (#15169)
• Ensure opacity modifiers and semi-transparent gradients render correctly by default in Safari (#15201)
• Fix element size thrashing when transitioning gradients on elements with a defined font-size in Safari (#15216)
• Ensure translate-* utilities work with arbitrary values that use calc(…) (#15215)
• Ensure gradient stop position utilities work with arbitrary values that use calc(…) (#15215)
• Ensure Node addons are packaged correctly with Windows ARM builds (#15171)
• Ensure the Vite plugin resolves CSS and JS files according to the configured resolver conditions ([#15173])(https://github.com/tailwindlabs/tailwindcss/pull/15173)
• Upgrade (experimental): Migrate prefixes for .group and .peer classes (#15208)

Changed

• Interpolate gradients using OKLAB instead of OKLCH by default (#15201)
• Error when layer(…) in @import is not first in the list of functions/conditions (#15109)
• Use unitless line-height values for font-size variables in default theme (#15216)
• Don't register custom properties with explicit types unless those custom properties need to be animateable (#15215)

Fixed

• Use configured --letter-spacing values for custom font size utilities (#15099)
• Ensure space-x/y-* and divide-x/y-* with variants can undo space-x/y-reverse and divide-x/y-reverse (#15094)
• Don't print minified code when the build fails in the CLI (#15106)
• Generate the correct CSS for the break-keep utility (#15108)
• Detect single word utilities that include numbers (e.g. h1) when scanning files (#15110)
• Upgrade (experimental): Always add layer(…) as the first param to @import (#15102)

Changed

• Revert the new base styles for buttons and form controls (#15100)

<a href="https://tailwindcss.com/blog/tailwindcss-v4-beta"><img alt="Tailwind CSS v4.0 Beta" src="https://assets.tailwindcss.com/blog/tailwindcss-v4-beta/card.jpg" width="768"></a>

About eight months ago we open-sourced our progress on Tailwind CSS v4.0. Hundreds of hours of fixing bugs, soul-crushing backward compatibility work, and troubleshooting Windows CI failures later, I'm excited to finally tag the first public beta release.

As I talked about when we published the first alpha, Tailwind CSS v4.0 is an all-new engine built for performance, and designed for the modern web.

• Built for performance — full builds in the new engine are up to 5x faster, and incremental builds are over 100x faster — and measured in microseconds.
• Unified toolchain — built-in import handling, vendor prefixing, and syntax transforms, with no additional tooling required.
• CSS-first configuration — a reimagined developer experience where you customize and extend the framework directly in CSS instead of a JavaScript configuration file.
• Designed for the modern web — built on native cascade layers, wide-gamut colors, and including first-class support for modern CSS features like container queries, @starting-style, popovers, and more.

There's so much more to say, but everything you need to get started is in the new beta documentation we published today:

Get started with Tailwind CSS v4.0 Beta 1 →

Start building and help us bullet-proof this thing for the stable release early in the new year.

Added

• Add consistent base styles for buttons and form controls (#15036)
• Upgrade (experimental): Convert group-[]:flex to in-[.group]:flex (#15054)
• Upgrade (experimental): Add form reset styles to CSS files for compatibility with v3 (#15036)
• Upgrade (experimental): Migrate ring to ring-3 (#15063)

Fixed

• Upgrade (experimental): Ensure migrating to the in-* requires a descendant selector (#15054)

Changed

• Use single drop shadow values instead of multiple (#15056)
• Do not parse invalid candidates with empty arbitrary values (#15055)

Added

• Reintroduce max-w-screen-* utilities that read from the --breakpoint namespace as deprecated utilities (#15013)
• Support using CSS variables as arbitrary values without var(…) by using parentheses instead of square brackets (e.g. bg-(--my-color)) (#15020)
• Add new in-* variant (#15025)
• Bundle @tailwindcss/forms, @tailwindcss/typography, and @tailwindcss/aspect-ratio with the standalone CLI (#15028)
• Allow addUtilities() and addComponents() to work with child combinators and other complex selectors (#15029)
• Support colors that use <alpha-value> in JS configs and plugins (#15033)
• Add new transition-discrete and transition-normal utilities for transition-behavior (#15051)
• Upgrade (experimental): Migrate [&>*] to the * variant (#15022)
• Upgrade (experimental): Migrate [&_*] to the ** variant (#15022)
• Upgrade (experimental): Warn when trying to migrating a project that is not on Tailwind CSS v3 (#15015)
• Upgrade (experimental): Migrate colors that use <alpha-value> in JS configs (#15033)

Fixed

• Ensure flex is suggested (#15014)
• Improve module resolution for cjs-only and esm-only plugins (#15041)
• Perform calc(…) on just values for negative -rotate-* utilities, not on the rotateX/Y/Z(…) functions themselves (#15044)
• Upgrade (experimental): Resolve imports when specifying a CSS entry point on the command-line (#15010)
• Upgrade (experimental): Resolve nearest Tailwind config file when CSS file does not contain @config (#15001)
• Upgrade (experimental): Improve output when CSS imports can not be found (#15038)
• Upgrade (experimental): Ignore analyzing imports with external URLs (e.g.: @import "https://fonts.google.com") (#15040)
• Upgrade (experimental): Ignore analyzing imports with url(…) (e.g.: @import url("https://fonts.google.com")) (#15040)
• Upgrade (experimental): Use resolveJsId when resolving tailwindcss/package.json (#15041)
• Upgrade (experimental): Ensure children of Tailwind root file are not considered Tailwind root files (#15048)

Changed

• Bring back support for color opacity modifiers to read from --opacity-* theme values (#14278)

Added

• Support opacity values in increments of 0.25 by default (#14980)
• Support specifying the color interpolation method for gradients via modifier (#14984)
• Reintroduce container component as a utility (#14993, #14999)
• Upgrade (experimental): Migrate container component configuration to CSS (#14999)

Fixed

• Ensure that CSS inside Svelte <style> blocks always run the expected Svelte processors when using the Vite extension (#14981)
• Upgrade (experimental): Ensure it's safe to migrate blur, rounded, or shadow (#14979)
• Upgrade (experimental): Do not rename classes using custom defined theme values (#14976)
• Upgrade (experimental): Ensure @config is injected in nearest common ancestor stylesheet (#14989)
• Upgrade (experimental): Add missing layer(…) to imports above Tailwind directives (#14982)

Fixed

• Don't reset horizontal padding on date/time pseudo-elements (#14959)
• Don't emit calc() with invalid values for bare values that aren't integers in spacing utilities (#14962)
• Ensure spacing scale values work as line-height modifiers (#14966)