●Change8

Migrating to Tailwind CSS v4.1.7

Version v4.1.7 introduces 1 breaking change. This guide details how to update your code.

Released: 5/15/2025

1
Breaking Changes
2
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

@theme@utility@importsource():merge()-rotate-*::before::after

Breaking Changes

●Issue #1

Upgrade migration now changes the casing of utilities with named values to kebab-case to align with updated theme variables.

Migration Steps

  1. 1
    Run the upgrade tool to migrate bare values to named values.
  2. 2
    Verify kebab-case utility names if using named values in theme variables.

Release Summary

This release focuses on improving the upgrade migration path, including better performance via caching and kebab-case normalization for named values, alongside several CSS extraction and CLI bug fixes.

Need More Details?

View the full release notes and all changes for Tailwind CSS v4.1.7.

View Full Changelog