Latest in branch 3.3
3.3.7
Released 18 Dec 2023
(2 years ago)
SoftwareTailwind CSS
Branch3.3
Initial release3.3.0
28 Mar 2023
(3 years ago)
Latest release3.3.7
18 Dec 2023
(2 years ago)
Support status18 Dec 2023
(Ended 2 years, 4 months ago)
Release noteshttps://github.com/tailwindlabs/tailwindcss/releases/tag/v3.3.7
Source codehttps://github.com/tailwindlabs/tailwindcss/tree/v3.3.7
Downloadhttps://github.com/tailwindlabs/tailwindcss/releases/tag/v3.3.7
Tailwind CSS 3.3 ReleasesView full list

What Is New in Tailwind CSS 3.3

Category Highlights
New Features 950 shade for every color, ESM/TS config files, logical-property RTL utilities, gradient stop percentages, built-in line-clamp, line-height shorthand, CSS-variable shorthand, font-variation-settings, list-image, hyphens, caption-side utilities.
Improvements Performance-optimized on-the-fly TypeScript transpilation, expanded color-contrast palette, more granular utility API.

How does Tailwind CSS 3.3 extend the color palette for dark mode?

Tailwind CSS 3.3 adds a 950 shade to every default color, giving you ultra-dark options for true dark-mode designs.

This extra shade sits between the existing 900 and pure black, making it easy to create high-contrast text and subtle UI surfaces without resorting to custom colors.

class="bg-gray-950 text-gray-100"

In practice you can now replace ad-hoc #111 values with bg-slate-950 or bg-indigo-950, keeping your design system consistent.

Can I write my Tailwind config as an ES module or in TypeScript?

Yes, Tailwind 3.3 natively supports ESM and TypeScript configuration files.

Running npx tailwindcss init --esm creates a tailwind.config.mjs that uses export default, while --ts generates a tailwind.config.ts with full type safety.

/* @type {import('tailwindcss').Config} */export default {
  content: [],
  theme: {
    extend: {},
  },
  plugins: [],
};

Behind the scenes Tailwind uses jiti and Sucrase to transpile the config on the fly, so you don't need a separate build step.

How can I simplify RTL support with logical properties in Tailwind 3.3?

Tailwind 3.3 introduces logical-property utilities that automatically adapt to left-to-right or right-to-left layouts.

Replace ml-3 rtl:mr-3 with a single ms-3 (margin-inline-start) and me-3 (margin-inline-end). The same pattern applies to padding, inset, border-width, border-color, border-radius, and scroll-margin/padding.

class="ms-4 me-2 ps-3 pe-3 rounded-s-lg rounded-e-md"

These utilities can still be combined with the ltr: and rtl: variants when you need explicit overrides.

What new utilities does Tailwind 3.3 provide for gradients, line-clamp, line-height and CSS variables?

Tailwind 3.3 adds fine-grained control over gradients, built-in line-clamp, a line-height shorthand, and a shorthand for CSS variables.

  • Gradient stops: from-5%, via-35%, to-85% (0-100% in 5% steps) or any arbitrary value like from-[21.56%].
  • Line-clamp: use line-clamp-3 to truncate multi-line text without a plugin.
  • Line-height shorthand: combine font size and line height with text-lg/7 or arbitrary values like text-sm/[17px].
  • CSS variable shorthand: omit var() in arbitrary values, e.g. bg-[--brand-color] and hover:bg-[--brand-hover-color].
class="bg-gradient-to-r from-indigo-500 from-10% via-purple-500 via-30% to-pink-500 to-90% line-clamp-4 text-lg/7 bg-[--brand-color] hover:bg-[--brand-hover-color]"

These utilities reduce the need for custom CSS and keep your design tokens in one place.

Frequently Asked Questions

Does upgrading to Tailwind CSS 3.3 require any breaking changes?
No breaking changes were introduced, you can upgrade by reinstalling the package.

How do I generate an ESM Tailwind config file?
Run npx tailwindcss init --esm and the file will export default with the proper syntax.

What is the syntax for using the new 950 color shade?
Use class names like bg-indigo-950 or text-emerald-950.

How do I apply a custom gradient stop at 21.56%?
Use a utility like from-cyan-400 from-[21.56%] inside your gradient class.

Can I use CSS variables without var() in Tailwind utilities?
Yes, write bg-[--brand-color] or hover:bg-[--brand-hover-color] directly.

Which utilities replace margin-left/right for RTL?
Use ms-3 for margin-inline-start and me-3 for margin-inline-end.

Releases In Branch 3.3

VersionRelease date
3.3.718 Dec 2023
(2 years ago)
3.3.604 Dec 2023
(2 years ago)
3.3.525 Oct 2023
(2 years ago)
3.3.424 Oct 2023
(2 years ago)
3.3.313 Jul 2023
(2 years ago)
3.3.225 Apr 2023
(3 years ago)
3.3.130 Mar 2023
(3 years ago)
3.3.028 Mar 2023
(3 years ago)