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.
- Don't set
display: none
on elements that use hidden="until-found"
(#14625)
- Improve source glob verification performance (#14481)
- Ensure using
@apply
with utilities that use @defaults
works with rules defined in the base layer when using optimizeUniversalDefaults
(#14427)
- Allow
anchor-size(…)
in arbitrary values (#14393)
- Bump versions of plugins in the Standalone CLI (#14185)
- No longer warns when broad glob patterns are detecting
vendor
folders
- Fix minification when using nested CSS (#14105)
- Warn when broad glob patterns are used in the content configuration (#14140)
- Fix class detection in Slim templates with attached attributes and ID (#14019)
- Ensure attribute values in
data-*
and aria-*
modifiers are always quoted in the generated CSS (#14037)
- Fix detection of some utilities in Slim/Pug templates (#14006)
- Loosen
:is()
wrapping rules when using an important selector (#13900)
- Disable automatic
var()
injection for anchor properties (#13826)
- Use no value instead of
blur(0px)
for backdrop-blur-none
and blur-none
utilities (#13830)
- Add
.mts
and .cts
config file detection (#13940)
- Don't generate utilities like
px-1
unnecessarily when using utilities like px-1.5
(#13959)
- Always generate
-webkit-backdrop-filter
for backdrop-*
utilities (#13997)
- Make it possible to use multiple
<alpha-value>
placeholders in a single color definition (#13740)
- Don't prefix classes in arbitrary values of
has-*
, group-has-*
, and peer-has-*
variants (#13770)
- Support negative values for
{col,row}-{start,end}
utilities (#13781)
- Update embedded browserslist database (#13792)
- Revert changes to glob handling (#13384)
- Ensure max specificity of
0,0,1
for button and input Preflight rules (#12735)
- Improve glob handling for folders with
(
, )
, [
or ]
in the file path (#12715)
- Split
:has
rules when using experimental.optimizeUniversalDefaults
(#12736)
- Sort arbitrary properties alphabetically across multiple class lists (#12911)
- Add
mix-blend-plus-darker
utility (#12923)
- Ensure dashes are allowed in variant modifiers (#13303)
- Fix crash showing completions in Intellisense when using a custom separator (#13306)
- Transpile
import.meta.url
in config files (#13322)
- Reset letter spacing for form elements (#13150)
- Fix missing
xx-large
and remove double x-large
absolute size (#13324)
- Don't error when encountering nested CSS unless trying to
@apply
a class that uses nesting (#13325)
- Ensure that arbitrary properties respect
important
configuration (#13353)
- Change dark mode selector so
@apply
works correctly with pseudo elements (#13379)
- Don't remove keyframe stops when using important utilities (#12639)
- Don't add spaces to gradients and grid track names when followed by
calc()
(#12704)
- Restore old behavior for
class
dark mode strategy (#12717)
- Improve glob handling for folders with
(
, )
, [
or ]
in the file path (#12715)
- Add new
selector
and variant
strategies for dark mode (#12717)
- Support
rtl
and ltr
variants on same element as dir
attribute (#12717)
- Add
svh
, lvh
, and dvh
values to default height
/min-height
/max-height
theme (#11317)
- Add
has-*
variants for :has(...)
pseudo-class (#11318)
- Add
text-wrap
utilities including text-balance
and text-pretty
(#11320, #12031)
- Extend default
opacity
scale to include all steps of 5 (#11832)
- Update Preflight
html
styles to include shadow DOM :host
pseudo-class (#11200)
- Increase default values for
grid-rows-*
utilities from 1–6 to 1–12 (#12180)
- Add
size-*
utilities (#12287)
- Add utilities for CSS subgrid (#12298)
- Add spacing scale to
min-w-*
, min-h-*
, and max-w-*
utilities (#12300)
- Add
forced-color-adjust
utilities (#11931)
- Add
forced-colors
variant (#11694, #12582)
- Add
appearance-auto
utility (#12404)
- Add logical property values for
float
and clear
utilities (#12480)
- Add
*
variant for targeting direct children (#12551)
- Simplify the
sans
font-family stack (#11748)
- Disable the tap highlight overlay on iOS (#12299)
- Improve relative precedence of
rtl
, ltr
, forced-colors
, and dark
variants (#12584)
- Fix support for container query utilities with arbitrary values (#12534)
- Fix custom config loading in Standalone CLI (#12616)
- Don’t add spaces to negative numbers following a comma (#12324)
- Don't emit
@config
in CSS when watching via the CLI (#12327)
- Improve types for
resolveConfig
(#12272)
- Ensure configured
font-feature-settings
for mono
are included in Preflight (#12342)
- Improve candidate detection in minified JS arrays (without spaces) (#12396)
- Don't crash when given applying a variant to a negated version of a simple utility (#12514)
- Fix support for slashes in arbitrary modifiers (#12515)
- Fix source maps of variant utilities that come from an
@layer
rule (#12508)
- Fix loading of built-in plugins when using an ESM or TypeScript config with the Standalone CLI (#12506)
- Fix incorrect spaces around
-
in calc()
expression (#12283)
- Improve normalisation of
calc()
-like functions (#11686)
- Skip
calc()
normalisation in nested theme()
calls (#11705)
- Fix incorrectly generated CSS when using square brackets inside arbitrary properties (#11709)
- Make
content
optional for presets in TypeScript types (#11730)
- Handle variable colors that have variable fallback values (#12049)
- Batch reading content files to prevent
too many open files
error (#12079)
- Skip over classes inside
:not(…)
when nested in an at-rule (#12105)
- Update types to work with
Node16
module resolution (#12097)
- Don’t crash when important and parent selectors are equal in
@apply
(#12112)
- Eliminate irrelevant rules when applying variants (#12113)
- Improve RegEx parser, reduce possibilities as the key for arbitrary properties (#12121)
- Fix sorting of utilities that share multiple candidates (#12173)
- Ensure variants with arbitrary values and a modifier are correctly matched in the RegEx based parser (#12179)
- Fix crash when watching renamed files on FreeBSD (#12193)
- Allow plugins from a parent document to be used in an iframe (#12208)
- Add types for
tailwindcss/nesting
(#12269)
- Bump
jiti
, fast-glob
, and browserlist
dependencies (#11550)
- Improve automatic
var
injection for properties that accept a <dashed-ident>
(#12236)
- Fix issue where some pseudo-element variants generated the wrong selector (#10943, #10962, #11111)
- Make font settings propagate into buttons, inputs, etc. (#10940)
- Fix parsing of
theme()
inside calc()
when there are no spaces around operators (#11157)
- Ensure
repeating-conic-gradient
is detected as an image (#11180)
- Move unknown pseudo-elements outside of
:is
by default (#11345)
- Escape animation names when prefixes contain special characters (#11470)
- Don't prefix arbitrary classes in
group
and peer
variants (#11454)
- Sort classes using position of first matching rule (#11504)
- Allow variant to be an at-rule without a prelude (#11589)
- Make PostCSS plugin async to improve performance (#11548)
- Don’t error when a config file is missing (f97759f)
- Add
aria-busy
utility (#10966)
- Reset padding for
<dialog>
elements in preflight (#11069)
- Don’t move unknown pseudo-elements to the end of selectors (#10943, #10962)
- Inherit gradient stop positions when using variants (#11002)
- Honor default
to
position of gradient when using implicit transparent colors (#11002)
- Ensure
@tailwindcss/oxide
doesn't leak in the stable engine (#10988)
- Ensure multiple
theme(spacing[5])
calls with bracket notation in arbitrary properties work (#11039)
- Normalize arbitrary modifiers (#11057)
- Drop support for Node.js v12 (#11089)
- Fix edge case bug when loading a TypeScript config file with webpack (#10898)
- Fix variant,
@apply
, and important
selectors when using :is()
or :has()
with pseudo-elements (#10903)
- Fix
safelist
config types (#10901)
- Fix build errors caused by
@tailwindcss/line-clamp
warning (#10915, #10919)
- Fix "process is not defined" error (#10919)
- Support ESM and TypeScript config files (#10785)
- Extend default color palette with new 950 shades (#10879)
- Add
line-height
modifier support to font-size
utilities (#9875)
- Add support for using variables as arbitrary values without
var(...)
(#9880, #9962)
- Add logical properties support for inline direction (#10166)
- Add
hyphens
utilities (#10071)
- Add
from-{position}
, via-{position}
and to-{position}
utilities (#10886)
- Add
list-style-image
utilities (#10817)
- Add
caption-side
utilities (#10470)
- Add
line-clamp
utilities from @tailwindcss/line-clamp
to core (#10768, #10876, #10862)
- Add
delay-0
and duration-0
utilities (#10294)
- Add
justify-normal
and justify-stretch
utilities (#10560)
- Add
content-normal
and content-stretch
utilities (#10645)
- Add
whitespace-break-spaces
utility (#10729)
- Add support for configuring default
font-variation-settings
for a font-family
(#10034, #10515)
- Disallow using multiple selectors in arbitrary variants (#10655)
- Sort class lists deterministically for Prettier plugin (#10672)
- Ensure CLI builds have a non-zero exit code on failure (#10703)
- Ensure module dependencies for value
null
, is an empty Set
(#10877)
- Fix format assumption when resolving module dependencies (#10878)
- Mark
rtl
and ltr
variants as stable and remove warnings (#10764)
- Use
inset
instead of top
, right
, bottom
, and left
properties (#10765)
- Make
dark
and rtl
/ltr
variants insensitive to DOM order (#10766)
- Use
:is
to make important selector option insensitive to DOM order (#10835)
- Fix use of
:where(.btn)
when matching !btn
(#10601)
- Revert including
outline-color
in transition
and transition-colors
by default (#10604)
- Fix installation failing with yarn and pnpm by dropping
oxide-api-shim
(add1636)
- Add standalone CLI build for 64-bit Windows on ARM (
node16-win-arm64
) (#10001)
- Cleanup unused
variantOrder
(#9829)
- Fix
foo-[abc]/[def]
not being handled correctly (#9866)
- Add container queries plugin to standalone CLI (#9865)
- Support renaming of output files by PostCSS plugins in CLI (#9944)
- Improve return value of
resolveConfig
, unwrap ResolvableTo
(#9972)
- Clip unbalanced brackets in arbitrary values (#9973)
- Don’t reorder webkit scrollbar pseudo elements (#9991)
- Deterministic sorting of arbitrary variants (#10016)
- Add
data
key to theme types (#10023)
- Prevent invalid arbitrary variant selectors from failing the build (#10059)
- Properly handle subtraction followed by a variable (#10074)
- Fix missing
string[]
in the theme.dropShadow
types (#10072)
- Update list of length units (#10100)
- Fix not matching arbitrary properties when closely followed by square brackets (#10212)
- Allow direct nesting in
root
or @layer
nodes (#10229)
- Don't prefix classes in arbitrary variants (#10214)
- Fix perf regression when checking for changed content (#10234)
- Fix missing
blocklist
member in the Config
type (#10239)
- Escape group names in selectors (#10276)
- Consider earlier variants before sorting functions (#10288)
- Allow variants with slashes (#10336)
- Ensure generated CSS is always sorted in the same order for a given set of templates (#10382)
- Handle variants when the same class appears multiple times in a selector (#10397)
- Handle group/peer variants with quoted strings (#10400)
- Parse alpha value from rgba/hsla colors when using variables (#10429)
- Sort by
layer
inside variants
layer (#10505)
- Add
--watch=always
option to prevent exit when stdin closes (#9966)
- Alphabetize
theme
keys in default config (#9953)
- Update esbuild to v17 (#10368)
- Include
outline-color
in transition
and transition-colors
utilities (#10385)
- Add
blocklist
option to prevent generating unwanted CSS (#9812)
- Fix watching of files on Linux when renames are involved (#9796)
- Make sure errors are always displayed when watching for changes (#9810)
- Fixed use of
raw
content in the CLI (#9773)
- Pick up changes from files that are both context and content deps (#9787)
- Sort pseudo-elements ONLY after classes when using variants and
@apply
(#9765)
- Support important utilities in the safelist (pattern must include a
!
) (#9791)
- Escape special characters in resolved content base paths (#9650)
- Don't reuse container for array returning variant functions (#9644)
- Exclude non-relevant selectors when generating rules with the important modifier (#9677)
- Fix merging of arrays during config resolution (#9706)
- Ensure configured
font-feature-settings
are included in Preflight (#9707)
- Fix fractional values not being parsed properly inside arbitrary properties (#9705)
- Fix incorrect selectors when using
@apply
in selectors with combinators and pseudos (#9722)
- Fix cannot read properties of undefined (reading 'modifier') (#9656, aa979d6)
- Fix missing
supports
in types (#9616)
- Fix missing PostCSS dependencies in the CLI (#9617)
- Ensure
micromatch
is a proper CLI dependency (#9620)
- Ensure modifier values exist when using a
modifiers
object for matchVariant
(ba6551d)
- Add new
@config
directive (#9405)
- Add new
relative: true
option to resolve content paths relative to the config file (#9396)
- Add new
supports-*
variant (#9453)
- Add new
min-*
and max-*
variants (#9558)
- Add new
aria-*
variants (#9557, #9588)
- Add new
data-*
variants (#9559, #9588)
- Add new
break-keep
utility for word-break: keep-all
(#9393)
- Add new
collapse
utility for visibility: collapse
(#9181)
- Add new
fill-none
utility for fill: none
(#9403)
- Add new
stroke-none
utility for stroke: none
(#9403)
- Add new
place-content-baseline
utility for place-content: baseline
(#9498)
- Add new
place-items-baseline
utility for place-items: baseline
(#9507)
- Add new
content-baseline
utility for align-content: baseline
(#9507)
- Add support for configuring default
font-feature-settings
for a font family (#9039)
- Add standalone CLI build for 32-bit Linux on ARM (
node16-linux-armv7
) (#9084)
- Add future flag to disable color opacity utility plugins (#9088)
- Add negative value support for
outline-offset
(#9136)
- Add support for modifiers to
matchUtilities
(#9541)
- Allow negating utilities using
min
/max
/clamp
(#9237)
- Implement fallback plugins when there is ambiguity between plugins when using arbitrary values (#9376)
- Support
sort
function in matchVariant
(#9423)
- Upgrade to
postcss-nested
v6.0 (#9546)
- Use absolute paths when resolving changed files for resilience against working directory changes (#9032)
- Fix ring color utility generation when using
respectDefaultRingColorOpacity
(#9070)
- Sort tags before classes when
@apply
-ing a selector with joined classes (#9107)
- Remove invalid
outline-hidden
utility (#9147)
- Honor the
hidden
attribute on elements in preflight (#9174)
- Don't stop watching atomically renamed files (#9173, #9215)
- Fix duplicate utilities issue causing memory leaks (#9208)
- Fix
fontFamily
config TypeScript types (#9214)
- Handle variants on complex selector utilities (#9262)
- Fix shared config mutation issue (#9294)
- Fix ordering of parallel variants (#9282)
- Handle variants in utility selectors using
:where()
and :has()
(#9309)
- Improve data type analysis for arbitrary values (#9320)
- Don't emit generated utilities with invalid uses of theme functions (#9319)
- Revert change that only listened for stdin close on TTYs (#9331)
- Ignore unset values (like
null
or undefined
) when resolving the classList for intellisense (#9385)
- Improve type checking for formal syntax (#9349, #9448)
- Fix incorrect required
content
key in custom plugin configs (#9502, #9545)
- Fix content path detection on Windows (#9569)
- Ensure
--content
is used in the CLI when passed (#9587)
- Don’t prefix classes within reused arbitrary variants (#8992)
- Fix usage of alpha values inside single-named colors that are functions (#9008)
- Fix
@apply
of user utilities when negative and non-negative versions both exist (#9027)
- Don't rewrite source maps for
@layer
rules (#8971)
- Added types for
resolveConfig
(#8924)
- Fix usage on Node 12.x (b4e637e)
- Handle theme keys with slashes when using
theme()
in CSS (#8831)
- Support configuring a default
font-weight
for each font size utility (#8763)
- Add support for alpha values in safe list (#8774)
- Improve types to support fallback values in the CSS-in-JS syntax used in plugin APIs (#8762)
- Support including
tailwindcss
and autoprefixer
in postcss.config.js
in standalone CLI (#8769)
- Fix using special-characters as prefixes (#8772)
- Don’t prefix classes used within arbitrary variants (#8773)
- Add more explicit types for the default theme (#8780)
- Provide default to
<alpha-value>
when using theme()
(#8652)
- Detect arbitrary variants with quotes (#8687)
- Don’t add spaces around raw
/
that are preceded by numbers (#8688)
- Fix extraction of multi-word utilities with arbitrary values and quotes (#8604)
- Fix casing of import of
corePluginList
type definition (#8587)
- Ignore PostCSS nodes returned by
addVariant
(#8608)
- Fix missing spaces around arithmetic operators (#8615)
- Detect alpha value in CSS
theme()
function when using quotes (#8625)
- Fix "Maximum call stack size exceeded" bug (#8636)
- Allow functions returning parallel variants to mutate the container (#8622)
- Remove text opacity CSS variables from
::marker
(#8622)
- Ensure
\
is a valid arbitrary variant token (#8576)
- Enable
postcss-import
in the CLI by default in watch mode (#8574, #8580)
- Fix candidate extractor regression (#8558)
- Split
::backdrop
into separate defaults group (#8567)
- Fix postcss plugin type (#8564)
- Fix class detection in markdown code fences and slim templates (#8569)
- Types: allow for arbitrary theme values (for 3rd party plugins) (#7926)
- Don’t split vars with numbers in them inside arbitrary values (#8091)
- Require matching prefix when detecting negatives (#8121)
- Handle duplicate At Rules without children (#8122)
- Allow arbitrary values with commas in
@apply
(#8125)
- Fix intellisense for plugins with multiple
@apply
rules (#8213)
- Improve type detection for arbitrary color values (#8201)
- Support PostCSS config options in config file in CLI (#8226)
- Remove default
[hidden]
style in preflight (#8248)
- Only check selectors containing base apply candidates for circular dependencies (#8222)
- Rewrite default class extractor (#8204)
- Move
important
selector to the front when @apply
-ing selector-modifying variants in custom utilities (#8313)
- Error when registering an invalid custom variant (#8345)
- Create tailwind.config.cjs file in ESM package when running init (#8363)
- Fix
matchVariant
that use at-rules and placeholders (#8392)
- Improve types of the
tailwindcss/plugin
(#8400)
- Allow returning parallel variants from
addVariant
or matchVariant
callback functions (#8455)
- Try using local
postcss
installation first in the CLI (#8270)
- Allow default ring color to be a function (#7587)
- Don't inherit
to
value from parent gradients (#8489)
- Remove process dependency from log functions (#8530)
- Ensure we can use
@import 'tailwindcss/...'
without node_modules (#8537)
- Only apply hover styles when supported (future) (#8394)
- Respect default ring color opacity (future) (#8448, 3f4005e)
- Support PostCSS
Document
nodes (#7291)
- Add
text-start
and text-end
utilities (#6656)
- Support customizing class name when using
darkMode: 'class'
(#5800)
- Add
--poll
option to the CLI (#7725)
- Add new
border-spacing
utilities (#7102)
- Add
enabled
variant (#7905)
- Add TypeScript types for the
tailwind.config.js
file (#7891)
- Add
backdrop
variant (#7924, #8526)
- Add
grid-flow-dense
utility (#8193)
- Add
mix-blend-plus-lighter
utility (#8288)
- Add arbitrary variants (#8299)
- Add experimental
matchVariant
API (#8310, 34fd0fb8)
- Add
prefers-contrast
media query variants (#8410)
- Add opacity support when referencing colors with
theme
function (#8416)
- Add
postcss-import
support to the CLI (#8437)
- Add
optional
variant (#8486)
- Add
<alpha-value>
placeholder support for custom colors (#8501)
- Prevent nesting plugin from breaking other plugins (#7563)
- Recursively collapse adjacent rules (#7565)
- Preserve source maps for generated CSS (#7588)
- Split box shadows on top-level commas only (#7479)
- Use local user CSS cache for
@apply
(#7524)
- Invalidate context when main CSS changes (#7626)
- Only add
!
to selector class matching template candidate when using important modifier with multi-class selectors (#7664)
- Correctly parse and prefix animation names with dots (#7163)
- Fix extraction from template literal/function with array (#7481)
- Don't output unparsable arbitrary values (#7789)
- Fix generation of
div:not(.foo)
if .foo
is never defined (#7815)
- Allow for custom properties in
rgb
, rgba
, hsl
and hsla
colors (#7933)
- Remove autoprefixer as explicit peer-dependency to avoid invalid warnings in situations where it isn't actually needed (#7949)
- Ensure the
percentage
data type is validated correctly (#8015)
- Make sure
font-weight
is inherited by form controls in all browsers (#8078)
- Replace
chalk
with picocolors
(#6039)
- Replace
cosmiconfig
with lilconfig
(#6039)
- Update
cssnano
to avoid removing empty variables when minifying (#7818)
- Remove opacity variables from
:visited
pseudo class (#7458)
- Support arbitrary values + calc + theme with quotes (#7462)
- Don't duplicate layer output when scanning content with variants + wildcards (#7478)
- Implement
getClassOrder
instead of sortClassList
(#7459)
- Temporarily move
postcss
to dependencies (#7424)
- Move prettier plugin to dev dependencies (#7418)
- Expose
context.sortClassList(classes)
(#7412)
- Fix preflight border color fallback (#7288)
- Correctly parse shadow lengths without a leading zero (#7289)
- Don't crash when scanning extremely long class candidates (#7331)
- Use less hacky fix for URLs detected as custom properties (#7275)
- Correctly generate negative utilities when dash is before the prefix (#7295)
- Detect prefixed negative utilities in the safelist (#7295)
- Fix
@apply
order regression (in addComponents
, addUtilities
, ...) (#7232)
- Quick fix for incorrect arbitrary properties when using URLs (#7252)
- Remove false positive warning in CLI when using the
--content
option (#7220)
- Ensure to transpile the PostCSS Nesting plugin (tailwindcss/nesting) (#7080)
- Improve various warnings (#7118)
- Fix grammatical mistake (cca5a38)
- Temporarily remove optional chaining in nesting plugin (#7077)
- Show warnings for invalid content config (#7065)
- Only emit utility/component variants when those layers exist (#7066)
- Ensure nesting plugins can receive options (#7016)
- Fix consecutive builds with at apply producing different CSS (#6999)
- Allow use of falsy values in theme config (#6917)
- Ensure we can apply classes that are grouped with non-class selectors (#6922)
- Improve standalone CLI compatibility on Linux by switching to the
linuxstatic
build target (#6914)
- Ensure
@apply
works consistently with or without @layer
(#6938)
- Only emit defaults when using base layer (#6926)
- Emit plugin defaults regardless of usage (#6926)
- Move default border color back to preflight (#6926)
- Change
experimental.optimizeUniversalDefaults
to only work with @tailwind base
(#6926)
- Preserve casing of CSS variables added by plugins (#6888)
- Ignore content paths that are passed in but don't actually exist (#6901)
- Revert change that applies Tailwind's defaults in isolated environments like CSS modules (9fdc391)
- Fix
@apply
in files without @tailwind
directives (#6580, #6875)
- CLI: avoid unnecessary writes to output files (#6550)
- Allow piping data into the CLI (#6876)
- Improve
DEBUG
flag (#6797, #6804)
- Ensure we can use
<
and >
characters in modifiers (#6851)
- Validate
theme()
works in arbitrary values (#6852)
- Properly detect
theme()
value usage in arbitrary properties (#6854)
- Improve collapsing of duplicate declarations (#6856)
- Remove support for
TAILWIND_MODE=watch
(#6858)
- Reduce specificity of
abbr
rule in preflight (#6671)
- Support HSL with hue units in arbitrary values (#6726)
- Add
node16-linux-arm64
target for standalone CLI (#6693)
- Don't mutate custom color palette when overriding per-plugin colors (#6546)
- Improve circular dependency detection when using
@apply
(#6588)
- Only generate variants for non-
user
layers (#6589)
- Properly extract classes with arbitrary values in arrays and classes followed by escaped quotes (#6590)
- Improve jsx interpolation candidate matching (#6593)
- Ensure
@apply
of a rule inside an AtRule works (#6594)
- Support square bracket notation in paths (#6519)
- Ensure all plugins are executed for a given candidate (#6540)
- Revert: add
li
to list-style reset (9777562d)
- Insert always-on defaults layer in correct spot (#6526)
- Warn about invalid globs in
content
(#6449)
- Add standalone tailwindcss CLI (#6506)
- Add
li
to list-style reset (00f60e6)
- Don't output unparsable values (#6469)
- Fix text decoration utilities from overriding the new text decoration color/style/thickness utilities when used with a modifier (#6378)
- Move defaults to their own always-on layer (#6500)
- Support negative values in safelist patterns (#6480)
- Temporarily disable optimize universal defaults, fixes issue with transforms/filters/rings not being
@apply
-able in CSS modules/Svelte components/Vue components (#6461)
- Ensure complex variants with multiple classes work (#6311)
- Re-add
default
interop to public available functions (#6348)
- Detect circular dependencies when using
@apply
(#6365)
- Fix defaults optimization when vendor prefixes are involved (#6369)
- Enforce the order of some variants (like
before
and after
) (#6018)
- Add
placeholder
variant (#6106)
- Add composable
touch-action
utilities (#6115)
- Add support for "arbitrary properties" (#6161)
- Add
portrait
and landscape
variants (#6046)
- Add
text-decoration-style
, text-decoration-thickness
, and text-underline-offset
utilities (#6004)
- Add
menu
reset to preflight (#6213)
- Allow
0
as a valid length
value (#6233, #6259)
- Add CSS functions to data types (#6258)
- Support negative values for
scale-*
utilities (c48e629)
- Improve
length
data type, by validating each value individually (#6283)
- Deprecate
decoration-slice
and decoration-break
in favor box-decoration-slice
and box-decoration-break
(non-breaking) (#6004)
- Don't use pointer cursor on disabled buttons by default (#5772)
- Set default content value in preflight instead of within each before/after utility (#5820)
- Remove
prefix
as a function (#5829)
- Add
flex-basis
utilities (#5671)
- Make negative values a first-class feature (#5709)
- Add
fit-content
values for min/max-width/height
utilities (#5638)
- Add
min/max-content
values for min/max-height
utilities (#5729)
- Add all standard
cursor-*
values by default (#5734)
- Add
grow-*
and shrink-*
utilities, deprecate flex-grow-*
and flex-shrink-*
(#5733)
- Add
text-decoration-color
utilities (#5760)
- Add new declarative
addVariant
API (#5809)
- Add first-class
print
variant for targeting printed media (#5885)
- Add
outline-style
, outline-color
, outline-width
and outline-offset
utilities (#5887)
- Add full color palette for
fill-*
and stroke-*
utilities (#5933[](https://github.com/tailwindlabs/tailwindcss/pull/5933))
- Add composable API for colored box shadows (#5979)
- Configure chokidar's
awaitWriteFinish
setting to avoid occasional stale builds on Windows (#5774)
- Fix CLI
--content
option (#5775)
- Fix before/after utilities overriding custom content values at larger breakpoints (#5820)
- Cleanup duplicate properties (#5830)
- Allow
_
inside url()
when using arbitrary values (#5853)
- Prevent crashes when using comments in
@layer
AtRules (#5854)
- Handle color transformations properly with
theme(...)
for all relevant plugins (#4533, #5871)
- Ensure
@apply
-ing a utility with multiple definitions works (#5870)
- Remove AOT engine, make JIT the default (#5340)
- Throw when trying to
@apply
the group
class (#4666)
- Remove dependency on
modern-normalize
, inline and consolidate with Preflight (#5358)
- Enable extended color palette by default with updated color names (#5384)
- Move
vertical-align
values to config file instead of hard-coding (#5487)
- Rename
overflow-clip
to text-clip
and overflow-ellipsis
to text-ellipsis
(#5630)
- Add native
aspect-ratio
utilities (#5359)
- Unify config callback helpers into single object (#5382)
- Preserve original color format when adding opacity whenever possible (#5154)
- Add
accent-color
utilities (#5387)
- Add
scroll-behavior
utilities (#5388)
- Add
will-change
utilities (#5448)
- Add
text-indent
utilities (#5449)
- Add
column
utilities (#5457)
- Add
border-hidden
utility (#5485)
- Add
align-sub
and align-super
utilities by default (#5486)
- Add
break-before
, break-inside
and break-after
utilities (#5530)
- Add
file
variant for ::file-selector-button
pseudo element (#4936)
- Add comprehensive arbitrary value support (#5568)
- Add
touch-action
utilities (#5603)
- Add
inherit
to default color palette (#5597)
- Add
overflow-clip
, overflow-x-clip
and overflow-y-clip
utilities (#5630)
- Add
[open]
variant (#5627)
- Add
scroll-snap
utilities (#5637)
- Add
border-x
and border-y
width and color utilities (#5639)
- Fix defining colors as functions when color opacity plugins are disabled (#5470)
- Fix using negated
content
globs (#5625)
- Fix using backslashes in
content
globs (#5628)
- Ensure
corePlugins
order is consistent in AOT mode (#5928)
- Bump versions for security vulnerabilities (#5924)
- Configure chokidar's
awaitWriteFinish
setting to avoid occasional stale builds on Windows (#5758)
- JIT: Properly handle animations that use CSS custom properties (#5602)
- Ensure using CLI without
-i
for input file continues to work even though deprecated (#5464)
- Only use
@defaults
in JIT, switch back to clean-css
in case there's any meaningful differences in the output (bf248cb)
- Replace
clean-css
with cssnano
for CDN builds to fix minified builds (75cc3ca)
- Ensure that divide utilities inject a default border color (#5438)
- Rebundle to fix missing CLI peer dependencies
- Fix build error when using
presets: []
in config file (#4903)
- Reintroduce universal selector optimizations under experimental
optimizeUniversalDefaults
flag (a9e160c)
- JIT: Fix
@apply
ing utilities that contain variants + the important modifier (#4854)
- JIT: Don't strip "null" when parsing tracked file paths (#5008)
- Pin
clean-css
to v5.1.4 to fix empty CSS variables in CDN builds (#5338)
- Improve accessibility of default link focus styles in Firefox (#5082)
- JIT: Fix animation variants corrupting keyframes rules (#5223)
- JIT: Ignore escaped commas when splitting selectors to apply prefixes (#5239)
- Nesting: Maintain PostCSS node sources when handling
@apply
(#5249)
- JIT: Fix support for animation lists (#5252)
- JIT: Fix arbitrary value support for
object-position
utilities (#5245)
- CLI: Abort watcher if stdin is closed to avoid zombie processes (#4997)
- JIT: Ignore arbitrary values with unbalanced brackets (#5293)
- Temporarily revert runtime performance optimizations introduced in v2.2.5, use universal selector again (#5060)
- Fix issue where base styles not generated for translate transforms in JIT (#5038)
- Added
self-baseline
utility (I know this is a patch release, no one's going to die relax) (#5000)
- JIT: Optimize universal selector usage by inlining only the relevant selectors (#4850))
This provides a very significant performance boost on pages with a huge number of DOM nodes, but there's a chance it could be a breaking change in very rare edge cases we haven't thought of. Please open an issue if anything related to shadows, rings, transforms, filters, or backdrop-filters seems to be behaving differently after upgrading.
- Fix support for
step-start
and step-end
in animation utilities (#4795))
- JIT: Prevent presence of
!*
in templates from ruining everything (#4816))
- JIT: Improve support for quotes in arbitrary values (#4817))
- Fix filter/backdrop-filter/transform utilities being inserted into the wrong position if not all core plugins are enabled (#4852))
- JIT: Fix
@layer
rules being mistakenly inserted during incremental rebuilds (#4853))
- Improve build performance for projects with many small non-Tailwind stylesheets (#4644)
- Ensure
[hidden]
works as expected on elements where we override the default display
value in Preflight (#4873)
- Fix variant configuration not being applied to
backdropOpacity
utilities (#4892)
- Remove
postinstall
script that was preventing people from installing the library (1eacfb9)
- Pass extended color palette to theme closures so it can be used without installing Tailwind when using
npx tailwindcss
(359252c)
- JIT: Explicitly error when
-
is used as a custom separator (#4704)
- JIT: Don't add multiple
~
when stacking peer-*
variants (#4757)
- Remove outdated focus style fix in Preflight (#4780)
- Enable
purge
if provided on the CLI (#4772)
- JIT: Fix error when not using a config file with postcss-cli (#4773)
- Fix issue with
resolveConfig
not being importable in Next.js pages (#4725)
- JIT: Reintroduce
transform
, filter
, and backdrop-filter
classes purely to create stacking contexts to minimize the impact of the breaking change (#4700)
- Recover from errors gracefully in CLI watch mode (#4693)
- Fix issue with media queries not being generated properly when using PostCSS 7 (#4695)
- JIT: Use "tracking" context by default instead of "watching" context for improved reliability with most bundlers (#4514)
Depending on which tooling you use, you may need to explicitly set TAILWIND_MODE=watch
until your build runner has been updated to support PostCSS's dir-dependency
message type.
- Add
background-origin
utilities (#4117)
- Improve
@apply
performance in projects that process many CSS sources (#3178)
- JIT: Don't use CSS variables for color utilities if color opacity utilities are disabled (#3984)
- JIT: Redesign
matchUtilities
API to make it more suitable for third-party use (#4232)
- JIT: Support applying important utility variants (#4260)
- JIT: Support coercing arbitrary values when the type isn't detectable (#4263)
- JIT: Support for
raw
syntax in purge
config (#4272)
- Add
empty
variant (#3298)
- Update
modern-normalize
to v1.1 (#4287)
- Implement
theme
function internally, remove postcss-functions
dependency (#4317)
- Add
screen
function to improve nesting plugin compatibility (#4318)
- JIT: Add universal shorthand color opacity syntax (#4348)
- JIT: Add
@tailwind variants
directive to replace @tailwind screens
(#4356)
- JIT: Add support for PostCSS
dir-dependency
messages in TAILWIND_DISABLE_TOUCH
mode (#4388)
- JIT: Add per-side border color utilities (#4404)
- JIT: Add support for
before
and after
pseudo-element variants and content
utilities (#4461)
- Add new
transform
and extract
APIs to simplify PurgeCSS/JIT customization (#4469)
- JIT: Add exhaustive pseudo-class and pseudo-element variant support (#4482)
- JIT: Add
caret-color
utilities (#4499)
- Rename
lightBlue
to sky
, emit console warning when using deprecated name (#4513)
- New CLI with improved JIT support,
--watch
mode, and more (#4526, 4558)
- JIT: Add new
peer-*
variants for styling based on sibling state (#4556)
- Expose
safelist
as a top-level option under purge
for both JIT and classic engines (#4580)
- JIT: Remove need for
transform
class when using classes like scale-*
, rotate-*
, etc. (#4604)
- JIT: Remove need for
filter
and backdrop-filter
classes when using classes like contrast-*
, backdrop-blur-*
, etc. (#4614)
- Support passing a custom path for your PostCSS configuration in the Tailwind CLI (#4607)
- Add
blur-none
by default with intent to deprecate blur-0
(#4614)
- JIT: Improve support for Svelte class bindings (#4187)
- JIT: Improve support for
calc
and var
in arbitrary values (#4147)
- Convert
hsl
colors to hsla
when transforming for opacity support instead of rgba
(#3850)
- Fix
backdropBlur
variants not being generated (#4188)
- Improve animation value parsing (#4250)
- Ignore unknown object types when hashing config (82f4eaa)
- Ensure variants are grouped properly for plugins with order-dependent utilities (#4273)
- JIT: Fix temp file storage when node temp directories are kept on a different drive than the project itself (#4044)
- Support border-opacity utilities alongside default
border
utility (#4277)
- JIT: Fix source maps for expanded
@tailwind
directives (2f15411)
- JIT: Ignore whitespace when collapsing adjacent rules (15642fb)
- JIT: Generate group parent classes correctly when using custom separator (#4508)
- JIT: Fix incorrect stacking of multiple
group
variants (#4551)
- JIT: Fix memory leak due to holding on to unused contexts (#4571)
- Add integration tests for popular build runners (#4354)
- Skip
raw
PurgeCSS sources when registering template dependencies (#4542)
- Register PurgeCSS paths as PostCSS dependencies to guarantee proper cache-busting in webpack 5 (#4530)
- Fix issue where JIT engine would generate the wrong CSS when using PostCSS 7 (#4078)
- Fix issue where JIT engine would fail to compile when a source path isn't provided by the build runner for the current input file (#3978)
- Add alternate JIT engine (in preview) (#3905)
- Add new
mix-blend-mode
and background-blend-mode
utilities (#3920)
- Add new
box-decoration-break
utilities (#3911)
- Add new
isolation
utilities (#3914)
- Add
inline-table
display utility (#3563)
- Add
list-item
display utility (#3929)
- Add new
filter
and backdrop-filter
utilities (#3923)
- Pass full
var(--bg-opacity)
value as opacityValue
when defining colors as functions
- Ensure sourcemap input is deterministic when using
@apply
in Vue components (#3356)
- Ensure placeholder opacity is consistent across browsers (#3308)
- Fix issue where
theme()
didn't work with colors defined as functions (#2919)
- Enable
dark
variants by default for color opacity utilities (#2975)
- Add support for a
tailwind.config.cjs
file in Node ESM projects (#3181)
- Add version comment to Preflight (#3255)
- Add
cursor-help
by default (#3199)
- Fix issue with
@apply
not working as expected with !important
inside an at-rule (#2824)
- Fix issue with
@apply
not working as expected with defined classes (#2832)
- Fix memory leak, and broken
@apply
when splitting up files (#3032)
- Add default values for the
ring
utility (#2951)
- Nothing, just the only thing I could do when I found out npm won't let me publish the same version under two tags.
- Add redesigned color palette (#2623, 700866c, #2633)
- Add dark mode support (#2279, #2631)
- Add
overflow-ellipsis
and overflow-clip
utilities (#1289)
- Add
transform-gpu
to force hardware acceleration on transforms when desired (#1380)
- Extend default spacing scale (#2630, 7f05204)
- Add spacing scale to
inset
plugin (#2630)
- Add percentage sizes to
translate
, inset
, and height
plugins (#2630, 5259560)
- Extend default font size scale (#2609, #2619)
- Support using
@apply
with complex classes, including variants like lg:hover:bg-blue-500
(#2159)
- Add new
2xl
breakpoint at 1536px by default (#2609)
- Add default line-height values for font-size utilities (#2609)
- Support defining theme values using arrays for CSS properties that support comma separated values (e13f083c4)
- Enable
group-hover
for color plugins, boxShadow
, and textDecoration
by default (28985b6, f6923b1)
- Enable
focus
for z-index utilities by default (ae5b3d3)
- Support
extend
in variants
configuration (#2651)
- Add
max-w-prose
class by default (#2574)
- Support flattening deeply nested color objects (#2148)
- Support defining presets as functions (#2680)
- Support deep merging of objects under
extend
(#2679, #2700)
- Enable
focus-within
for all plugins that have focus
enabled by default (1a21f072, f6923b1)
- Added new
ring
utilities for creating outline/focus rings using box shadows (#2747, 879f088, e0788ef)
- Added
5
and 95
to opacity scale (#2747)
- Add support for default duration and timing function values whenever enabling transitions (#2755)
- Completely redesign color palette (#2623, 700866c, #2633)
- Drop support for Node 8 and 10 (#2582)
- Removed
target
feature and dropped any compatibility with IE 11 (#2571)
- Upgrade to PostCSS 8 (but include PostCSS 7 compatibility build) (729b400, 1d8679d, c238ed1)
- Removed
shadow-outline
, shadow-solid
, and shadow-xs
by default in favor of new ring
API (#2747)
- Switch
normalize.css
to modern-normalize
(#2572)
- Rename
whitespace-no-wrap
to whitespace-nowrap
(#2664)
- Rename
flex-no-wrap
to flex-nowrap
(#2676)
- Remove
clearfix
utility, recommend flow-root
instead (#2766)
- Disable
hover
and focus
for fontWeight
utilities by default (f6923b1)
- Remove
grid-gap
fallbacks needed for old versions of Safari (5ec45fa)
- Change special use of 'default' in config to 'DEFAULT' (#2580)
- New
@apply
implementation, slight backwards incompatibilities with previous behavior (#2159)
- Make
theme
retrieve the expected resolved value when theme value is complex (e13f083c4)
- Move
truncate
class to textOverflow
core plugin (#2562)
- Remove
scrolling-touch
and scrolling-auto
utilities (#2573)
- Modernize default system font stacks (#1711)
- Upgrade to PurgeCSS 3.0 (8e4e0a0)
- Change default
text-6xl
font-size to 3.75rem instead of 4rem (#2619)
- Ignore
[hidden]
elements within space
and divide
utilities instead of template
elements (#2642)
- Automatically prefix keyframes and animation names when a prefix is configured (#2621, #2641)
- Merge
extend
objects deeply by default (#2679)
- Respect
preserveHtmlElements
option even when using custom PurgeCSS extractor (#2704)
- Namespace all internal custom properties under
tw-
to avoid collisions with end-user custom properties (#2771)
- Fix issue where
ring-offset-0
didn't work due to unitless 0
in calc
function (3de0c48)
- Don't override ring color when overriding ring width with a variant (e40079a)
- Prevent shadow/ring styles from cascading to children (e40079a)
- Ensure rings have a default color even if
colors.blue.500
is not present in config (e40079a)
- Add scripts for generating a PostCSS 7 compatible build alongside PostCSS 8 version (#2773)
- All custom properties have been internally namespaced under
tw-
to avoid collisions with end-user custom properties (#2771)
All custom properties have been internally namespaced under tw-
to avoid collisions with end-user custom properties (#2771) I made a git boo-boo, check alpha.23 instead
- Upgrade to PostCSS 8, Autoprefixer 10, move
postcss
and autoprefixer
to peerDependencies (729b400)
- Remove
clearfix
utility, recommend flow-root
instead (#2766)
- Don't crash when color palette is empty (278c203)
black
and white
have been added to colors.js
(b3ed724)
- Add support for colors as closures to
ringColor
and ringOffsetColor
, previously would crash build (62a47f9)
- Remove
grid-gap
fallbacks needed for old versions of Safari (5ec45fa)
- Enable
focus
, focus-within
, and dark
variants (when enabled) for all ring utilities by default (e0788ef)
- Added
ring-inset
utility for rendering rings as inset shadows (879f088)
ringWidth
utilities always reset ring styles to ensure no accidental variable inheritance through the cascade (879f088)
- Enable
focus-within
for outline
utilities by default (f6923b1)
- Enable
focus-within
for ringWidth
utilities by default (f6923b1)
- Enable
group-hover
for boxShadow
utilities by default (f6923b1)
- Enable
group-hover
and focus-within
for textDecoration
utilities by default (f6923b1)
- Disable
hover
and focus
for fontWeight
utilities by default (f6923b1)
- Add support for default duration and timing function values whenever enabling transitions (#2755)
- Prevent
boxShadow
utilities from overriding ring shadows added by components like in the custom forms plugin (c3dd3b6)
- Convert
none
to 0 0 #0000
when used for shadows to ensure compatibility with ring
utilities (4eecc27)
- Added new
ring
utilities (#2747)
- Added
5
and 95
to opacity scale (#2747)
- Removed
shadow-outline
, shadow-solid
, and shadow-xs
in favor of new ring
API (#2747)
- Added
shadow-solid
utility, a 2px solid shadow that uses the current text color (369cfae)
- Enable
focus-within
where useful by default (1a21f072)
- Update
shadow-outline
to use the new blue (b078238)
- Add
11
to spacing scale (7f05204)
- Add percentage-based height values (5259560)
- Add indigo to the color palette by default (700866c)
- Use
coolGray
as the default gray (700866c)
- Revert upgrading to PostCSS 8 lol
- Respect
preserveHtmlElements
option even when using custom PurgeCSS extractor (#2704)
- Set font-family and line-height to
inherit
on body
to behave more like v1.x (#2729)
- Support deep merging of arrays of objects under
extend
(#2700)
- Support flattening deeply nested color objects (#2148)
- Support defining presets as functions (#2680)
- Merge
extend
objects deeply by default (#2679)
- Rename
flex-no-wrap
to flex-nowrap
(#2676)
- Support
extend
in variants
configuration (#2651)
- Add
max-w-prose
class by default (#2574)
- Revert use of logical properties for
space
and divide
utilities (#2644)
space
and divide
utilities ignore elements with [hidden]
now instead of only ignoring template
elements (#2642)
- Set default font on
body
, not just html
(#2643)
- Automatically prefix keyframes and animation names when a prefix is configured (#2621, #2641)
- Rename
whitespace-no-wrap
to whitespace-nowrap
(#2664)
- The
presets
feature had unexpected behavior where a preset config without its own presets
key would not extend the default config. (#2662)
If you were depending on this unexpected behavior, just add presets: []
to your own preset to exclude the default configuration.
- Added dark mode support (#2279, #2631)
- Added
overflow-ellipsis
and overflow-clip
utilities (#1289)
- Add
transform-gpu
to force hardware acceleration on transforms when beneficial (#1380)
- Extended spacing scale (#2630)
- Add spacing scale to
inset
plugin (#2630)
- Enable useful relative sizes for more plugins (#2630)
- Extend font size scale (#2609, #2619)
- Support using
@apply
with complex classes (#2159)
- Add new
2xl
breakpoint (#2609)
- Add default line-height values for font-size utilities (#2609)
- Support defining theme values using arrays wherever it makes sense (box-shadow, transition-property, etc.) (e13f083c4)
- Enable
group-hover
for color utilities by default (28985b6)
- Enable
focus
for z-index utilities by default (ae5b3d3)
- New
@apply
implementation, slight backwards incompatibilities with previous behavior (#2159)
- Move
truncate
class to textOverflow
core plugin (#2562)
- Removed
target
feature and dropped any compatibility with IE 11 (#2571)
- Switch
normalize.css
to modern-normalize
(#2572)
- Remove
scrolling-touch
and scrolling-auto
utilities (#2573)
- Change special use of 'default' in config to 'DEFAULT' (#2580)
- Drop support for Node 8 and 10 (#2582)
- Modernize default system font stacks (#1711)
- Upgrade to PurgeCSS 3.0
Upgrade to PostCSS 8.0 Reverted for now
- Use logical properties for
space
and divide
utilities (#1883)
- Make
theme
retrieve the expected resolved value when theme value is complex (e13f083c4)
- Adjust default font-size scale to include 60px instead of 64px (#2619)
- Update default colors in Preflight to match new color palette (#2633)
- Fix issue where using
theme
with default line-heights did not resolve correctly
- Fix issue changing plugins defined using the
withOptions
API would not trigger rebuilds in watch processes
- Remove console warnings about upcoming breaking changes
- Merge plugins when merging config with preset (#2561
- Use
word-wrap
and overflow-wrap
together, not one or the other since word-wrap
is IE-only
- Don't import
corePlugins
in resolveConfig
to avoid bundling browser-incompatible code (#2548)
- Add new
presets
config option (#2474)
- Scaffold new
tailwind.config.js
files with available future
flags commented out (#2379)
- Add
col-span-full
and row-span-full
(#2471)
- Make
outline
configurable, outline-none
more accessible by default, and add outline-black
and outline-white
(#2460)
- Add additional small
rotate
and skew
values (#2528)
- Add
xl
, 2xl
, and 3xl
border radius values (#2529)
- Add new utilities for
grid-auto-columns
and grid-auto-rows
(#2531)
- Promote
defaultLineHeights
and standardFontWeights
from experimental to future
- Don't escape keyframe values (#2432)
- Use
word-wrap
instead of overflow-wrap
in ie11
target mode (#2391)
- Add experimental
2xl
breakpoint (#2468)
- Rename
{u}-max-content
and {u}-min-content
utilities to {u}-max
and {u}-min
in experimental extended spacing scale (#2532)
- Support disabling dark mode variants globally (#2530)
- Support defining colors as closures even when opacity variables are not supported (#2536)
- Reset color opacity variable in utilities generated using closure colors (#2515)
- Make
tailwindcss.plugin
work in ESM environments for reasons
- Prevent new
dark
experiment from causing third-party dark
variants to inherit stacking behavior (#2382)
- Add negative spacing values to inset plugin in the
extendedSpacingScale
experiment (#2358)
- Fix issue where
!important
was stripped from declarations within rules that used @apply
with applyComplexClasses
(#2376)
- Register dark mode plugin outside of
resolveConfig
code path (#2368)
- Fix issue where classes in escaped strings (like
class=\"block\"
) weren't extracted properly for purging (#2364)
- Fix issue where container padding not applied when using object syntax (#2353)
- Fix issue where
resolveConfig
didn't take into account configs added by feature flags (#2347)
- Fix issue where inserting extra PurgeCSS control comments could break integrated PurgeCSS support
- Fix issue where dark variant in 'class' mode was incompatible with 'group-hover' variant (#2337)
- Support basic nesting structure with
@apply
when using the applyComplexClasses
experiment (#2271)
- Rename
font-hairline
and font-thin
to font-thin
and font-extralight
behind standardFontWeights
flag (experimental until v1.9.0) (#2333)
- Fix issue where
font-variant-numeric
utilities would break in combination with most CSS minifier configurations (f3660ce)
- Only warn about
conservative
purge mode being deprecated once per process (58781b5)
- Fix bug where dark mode variants would cause an error if you had a
plugins
array in your config (#2322)
- Fix bug in the new font-variant-numeric utilities which broke the whole rule (#2318)
- Fix bug while purging (#2320)
- Dark mode variant (experimental) (#2279)
- New
preserveHtmlElements
option for purge
(#2283)
- New
layers
mode for purge
(#2288)
- New
font-variant-numeric
utilities (#2305)
- New
place-items
, place-content
, place-self
, justify-items
, and justify-self
utilities (#2306)
- Support configuring variants as functions (#2309)
- CSS within
@layer
at-rules are now grouped with the corresponding @tailwind
at-rule (#2312)
conservative
purge mode, deprecated in favor of layers
- Fix bug where the new experimental
@apply
implementation broke when applying a variant class with the important option globally enabled
- Update lodash to latest to silence security warnings
- Add new -p flag to CLI to quickly scaffold a
postcss.config.js
file
- Make
@apply
insensitive to whitespace in the new applyComplexClasses
experiment
- Fix bug where the new
applyComplexClasses
experiment didn't behave as expected with rules with multiple selectors, like .foo, .bar { color: red }
- Log feature flag notices to stderr instead of stdout to preserve compatibility with pipe-based build systems
- Add missing bg-none utility for disabling background images
- Fix bug that prevented defining colors as closures when the
gradientColorStops
plugin was enabled
- Reuse generated CSS as much as possible in long-running processes instead of needlessly recalculating
- Don't issue duplicate flag notices in long-running build processes
- Gradients
- New background-clip utilities
- New
contents
display utility
- Default letter-spacing per font-size
- Divide border styles
- Access entire config object from plugins
- Define colors as closures
- Use
@apply
with variants and other complex classes (experimental)
- New additional color-palette (experimental)
- Extended spacing scale (experimental)
- Default line-heights per font-size by default (experimental)
- Extended font size scale (experimental)
- Fixes issue where motion-safe and motion-reduce variants didn't stack correctly with group-hover variants
- Fixes issue where
@keyframes
respecting the important option would break animations in Chrome
- Fixes an issue where animation keyframes weren't included in the build without @tailwind base (#2108)
- Animation support
- New
prefers-reduced-motion
variants
- New
overscroll-behaviour
utilities
- Generate CSS without an input file
- Fixes issue where you could no longer use
@apply
with unprefixed class names if you had configured a prefix
- Fixes accidental breaking change where adding component variants using the old manual syntax (as recommended in the docs) stopped working
- Component
variants
support
- Responsive
container
variants
- New
focus-visible
variant
- New
checked
variant
No release notes
- Explicitly error when using a class as the important config option instead of just generating the wrong CSS
- Fix bug where the
divideColor
plugin was using the wrong '' in IE11 target mode
- Fix bug where target: 'browserslist' didn't work, only
target: ['browserslist', {...}]
did
- Don't generate unnecessary CSS in color plugins when color opacity utilities are disabled
- Fix issue where
purge: { enabled: false }
was ignored, add purge: false
shorthand
- Improve built-in PurgeCSS extractor to better support Haml and Slim templates
- New color opacity utilities
- Built-in PurgeCSS
- IE 11 target mode (experimental)
- Drop
fs-extra
dependency to ^8.0.0
to preserve Node 8 compatibility until Tailwind 2.0
- Fix missing unit in calc bug in space plugin (
space-x-0
didn't work for example)
- Fix bug where
divide-{x/y}-0
utilities didn't work due to missing unit in calc
call
- Add forgotten responsive variants for
space
, divideWidth
, and divideColor
utilities
- Fix bug where the
space-x
utilities were not being applied correctly due to referencing --space-y-reverse
instead of --space-x-reverse
- New
space
and divide
layout utilities
- New
transition-delay
utilities
- New
group-focus
variant
- Support for specifying a default line-height for each font-size utility
- Support for breakpoint-specific padding for
container
class
- Added
current
to the default color palette
- New
inline-grid
utility
- New
flow-root
display utility
- New
clear-none
utility
- CSS Transition support
- CSS Transform support
- CSS Grid support
- Added
max-w-{screen}
utilities
- Added
max-w-none
utility
- Added
rounded-md
utility
- Added
shadow-sm
utility
- Added
shadow-xs
utility
- Added
stroke-width
utilities
- Added fixed line-height utilities
- Added additional display utilities for table elements
- Added box-sizing utilities
- Added clear utilities
- Config file dependencies are now watchable
- Added new
plugin
and plugin.withOptions
APIs
- Allow plugins to extend the user's config
- Add additional fixed-size line-height utilities
- Remove Inter from font-sans, plan to add later under new class
- Add system-ui to default font stack
- Add shadow-xs, increase shadow-sm alpha to 0.05
- Support import syntax even without postcss-import
- Alias tailwind bin to tailwindcss
- Add fill/stroke to transition-colors
- Add transition-shadow, add box-shadow to default transition
- Combine gap/columnGap/rowGap
- Add grid row utilities
- Add skew utilities
- Use font-sans as default font
- Adds missing dependency
resolve
which is required for making config dependencies watchable
- CSS Transition support
- CSS Transform support
- CSS Grid support
- New
max-w-{screen}
utilities
- Added
max-w-none
utility
- Added "Inter" to the default sans-serif font stack
- Add
rounded-md
utility
- Add
shadow-sm
utility
- Added stroke-width utilities
- Added additional display utilities for table elements
- Added box-sizing utilities
- Added clear utilities
- Config file dependencies are now watchable
- Allow plugins to extend the user's config
- Add new
plugin
and plugin.withOptions
APIs
[v1.2.0-canary.3] - 2020-01-08 [YANKED]
No release notes
- Note: Although this is a bugfix it could affect your site if you were working around the bug in your own code by not prefixing the
.group
class. I'm sorry 😞
- Fixes a bug where the
.group
class was not receiving the user's configured prefix when using the prefix
option
- Don't watch
node_modules
files for changes
- Fixes significant build performance regression in
v1.2.0-canary.0
- Fixes an issue where in some cases function properties in the user's
theme
config didn't receive the second utils argument
- Automatically watch all config file dependencies (plugins, design tokens imported from other files, etc.) for changes when build watcher is running
- Add
justify-evenly
utility
- Allow plugins to add their own config file to be resolved with the user's custom config
- Fixes a bug with horizontal rules where they were displayed with a 2px border instead of a 1px border
- Fixes a bug with horizontal rules where they were rendered with default top/bottom margin
- Fixes issue where values like
auto
would fail to make it through the default negative margin config
- Added utilities for screenreader visibility
- Added utilities for placeholder color
- First, last, even, and odd child variants
- Disabled variant
- Visited variant
- Increase utility specificity using a scope instead of !important
- Add hover/focus variants for opacity by default
- Added
border-double
utility
- Support negative prefix for boxShadow and letterSpacing plugins
- Support passing config path via object
- Placeholders no longer have a default opacity
- Make horizontal rules visible by default
- Generate correct negative margins when using calc
- Fixes issue where modifiers would mutate nested rules
- Support built-in variants for utilities that include pseudo-elements
- Update several dependencies, including postcss-js which fixes an issue with using
!important
directly in Tailwind utility plugins
- Increase precision of percentage width values to avoid 1px rounding issues in grid layouts
- Throws an error when someone tries to use
@tailwind preflight
instead of @tailwind base
, this is the source of many support requests
- Fixes a bug where
@screen
rules weren't bubbled properly when nested in plugins
- Fixes a bug where global variants weren't properly merged
No release notes
- Use
9999
and -9999
for order-last
and order-first
utilities respectively
- Add
bg-repeat-round
and bg-repeat-space
utilities
- Add
select-all
and select-auto
utilities
- Make all utilities responsive by default
- Adds
responsive
variants for the new order utilities by default, should have been there all along
- Fixes a bug where you couldn't extend the margin config
- Added support for negative inset (
-top-6
, -right-4
) and z-index (-z-10
) utilities, using the same negative key syntax supported by the margin plugin
- Add missing fractions as well as x/12 fractions to width scale
- Add
order
utilities
- Add
cursor-text
class by default
- Make it possible to access your fully merged config file in JS
- Removed
negativeMargin
plugin, now the regular margin
plugin supports generating negative classes (like -mx-6
) by using negative keys in the config, like -6
- Make it possible to disable all core plugins using
corePlugins: false
- Make it possible to configure a single list of variants that applies to all utility plugins
- Make it possible to safelist which core plugins should be enabled
- Fix a bug where stroke and fill plugins didn't properly handle the next object syntax for color definitions
- Fix a bug where you couldn't have comments near
@apply
directives
- Add the
container
key to the scaffolded config file when generated with --full
- Bumps node dependency to 8.9.0 so we can keep our default config file clean, 6.9.0 is EOL next month anyways
- Removes
SFMono-Regular
from the beginning of the default monospace font stack, it has no italic support and Menlo looks better anyways
- Fixes an issue where the user's config object was being mutated during processing (only affects @bradlc 😅)
- Fixes an issue where you couldn't use a closure to define theme sections under
extend
- Support lazy evaluation in
theme.extend
- Use lighter default border color
- Revert #745 and use
bolder
for strong tags by default instead of fontWeight.bold
- Closures in the
theme
section of the config file are now passed a theme
function instead of an object
- Fix issue where
@screen
didn't work at all 🙃
- New config file structure
- New expanded default color palette
- New default
maxWidth
scale
- Added utilities for
list-style-type
and list-style-position
- Added
break-all
utility
object-position
utilities are now customizable under theme.objectPosition
cursor
utilities are now customizable under theme.cursors
flex-grow/shrink
utilities are now customizable under theme.flexGrow/flexShrink
- Default variant output position can be customized
- Extended default line-height scale
- Extended default letter-spacing scale
- Update our PostCSS related dependencies
- Fix bug where class names containing a
.
character had the responsive prefix added in the wrong place
- Update Normalize to v8.0.1
- Add
--no-autoprefixer
option to CLI build
command
- Update autoprefixer dependency
- Registering new variants from plugins
- Variant order can be customized per module
- Added focus-within variant
- Fancy CLI updates
- Option to generate config without comments
- Make configured prefix optional when using @apply
- Improve Flexbox behavior in IE 10/11
- Variant order in modules is now significant
- Normalize.css updated to v8.0.0
- Removed CSS fix for Chrome 62 button border radius change
- Promote
shadowLookup
from experiment to official feature
- Fixes an issue where units were stripped from zero value properties
- Fixes an issue where changes to your configuration file were ignored when using
webpack --watch
- Fixes an issue where
@tailwind utilities
generated no output
- Added table layout utilities for styling tables
- Configuration can now be passed as an object
- Registering new variants from plugins (experimental)
- Allow
@apply
-ing classes that aren't defined but would be generated (experimental)
- Default config file changes
- Fix incorrect box-shadow syntax for the
.shadow-outline
utility 🤦♂️
- Added border collapse utilities for styling tables
- Added more axis-specific overflow utilities
- Added
.outline-none
utility for suppressing focus styles
- Added
.shadow-outline
utility as an alternative to default browser focus styles
- Extended default padding, margin, negative margin, width, and height scales
- Enable focus and hover variants for more modules by default
- Removed default
outline: none !important
styles from focusable but keyboard-inaccessible elements
- Moved screen prefix for responsive
group-hover
variants
- Default config file changes
- Improve sourcemaps for replaced styles like
preflight
- Fix bug where informational messages were being logged to stdout during build, preventing the ability to use Tailwind's output in Unix pipelines
- Fixes an issue with a dependency that had a security vulnerability
- Reverts a change that renamed the
.roman
class to .not-italic
due to the fact that it breaks compatibility with cssnext: postcss/postcss-selector-not#10. We'll stick with .roman
for now with a plan to switch to .not-italic
in another breaking version should that issue get resolved in postcss-selector-not.
- Plugin system
- Added
.sticky position
utility
- Added
.cursor-wait
and .cursor-move
utilities
- Added
.bg-auto
background size utility
- Background sizes are now customizable
- Support for active variants
- Better postcss-import support
- Configuration options for the
.container
component
- The
.container
component is now a built-in plugin
- State variant precedence changes
- New config file keys
.overflow-x/y-scroll
now set overflow: scroll
instead of overflow: auto
.roman
renamed to .not-italic
- Use
global.Object
to avoid issues with polyfills when importing the Tailwind config into other JS
- Add support for using a function to define class prefixes in addition to a simple string
- Improve the performance of @apply by using a lookup table instead of searching
- Fix an issue where borders couldn't be applied to
img
tags without specifying a border style
- Make default sans-serif font stack more future proof and safe to use with CSS
font
shorthand
- Replace stylefmt with Perfectionist to avoid weird stylelint conflicts
@apply
'd classes can now be made !important
explicitly
@apply
now strips !important
from any mixed in classes
- Default color palette tweaks
- Enable/disable modules and control which variants are generated for each
- Focus variants
- Group hover variants
- New
@variants
at-rule
- Customize the separator character
- Missing config keys now fallback to their default values
- New utilities
- Lists now have no margins by default
.pin
no longer sets width and height to 100%
- SVG
fill
no longer defaults to currentColor
- Fix issue with dist files not being published due to bug in latest npm
- Fix overly specific border-radius reset for Chrome 62 button styles
- Add a custom prefix to all utilities
- Optionally make all utilities
!important
- Round element corners independently
- Cascading border colors and styles
auto
is no longer a hard-coded margin value
- The
defaultConfig
function is now a separate module
- Rounded utilities now combine position and radius size
- Border width utilities no longer affect border color/style
@apply
is now very strict about what classes can be applied
- Add
options
key to your config
- Spacing, radius, and border width utility declaration order changes
- Fix CDN files not being published to npm
- Apply the same default placeholder styling that's applied to inputs to textareas
- Fix CLI tool not loading config files properly
- Autoprefix dist assets for quick hacking and prototyping
- Add
my-auto
, mt-auto
, and mb-auto
margin utilities
- Add
sans-serif
to end of default sans
font stack
- If using Webpack, it will now watch your config file changes
- When running
tailwind init [filename]
, automatically append .js
to filename if not present
- Support default fallback value in
config(...)
function, ie. config('colors.blue', #0000ff)
- Don't output empty media queries if Tailwind processes a file that doesn't use Tailwind
- Move list utilities earlier in stylesheet to allow overriding with spacing utilities
- Add new
.scrolling-touch
and .scrolling-auto
utilities for controlling inertial scroll behavior on WebKit touch devices
- Generate separate dist files for preflight, utilities, and tailwind for CDN usage
- Target Node 6.9.0 explicitly (instead of 8.6 implicitly) to support more users
- Fix issue with config option not being respected in
tailwind build
- Fix
tailwind build
CLI command not writing output files