v3.1.0

We just released Tailwind CSS v3.1 — the first new feature release since v3.0 came out last year!

Read the announcement post for all the details, and watch the YouTube video for a tour of some of the highlights.

---

Added

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

Fixed

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

Changed

• Only apply hover styles when supported (future) (#8394)
• Respect default ring color opacity (future) (#8448, 3f4005e)

v3.0.24

Fixed

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

Changed

• Replace chalk with picocolors (#6039)
• Replace cosmiconfig with lilconfig (#6039)
• Update cssnano to avoid removing empty variables when minifying (#7818)

v3.0.23

Fixed

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

v3.0.22

Fixed

• Temporarily move postcss to dependencies (#7424)

v3.0.21

Fixed

• Move prettier plugin to dev dependencies (#7418)

v3.0.20

Added

• Expose context.sortClassList(classes) (#7412)

v3.0.19

Fixed

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

v3.0.18

Fixed

• Fix @apply order regression (in addComponents, addUtilities, ...) (#7232)
• Quick fix for incorrect arbitrary properties when using URLs (#7252)

v3.0.17

Fixed

• Remove false positive warning in CLI when using the --content option (#7220)

v3.0.16

Fixed

• Ensure to transpile the PostCSS Nesting plugin (tailwindcss/nesting) (#7080)
• Improve various warnings (#7118)
• Fix grammatical mistake (cca5a38)