●Change8

Migrating to Tailwind CSS v4.1.0

Version v4.1.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/1/2025

2
Breaking Changes
3
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

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

@source@tailwindcss/cli--theme()items-baseline-lastself-baseline-lasttext-shadowmaskbg-left-topobject-left-top

Breaking Changes

●Issue #1

node_modules is now ignored by default for class scanning. If you rely on scanning node_modules, you must now explicitly include them using @source rules.

●Issue #2

@source rules that include file extensions or point inside node_modules/ folders no longer respect .gitignore rules.

Migration Steps

  1. 1
    If scanning classes inside node_modules, add explicit @source rules to your CSS.
  2. 2
    Update background position utilities from bg-{side}-{side} to bg-{top/bottom}-{left/right} format.
  3. 3
    Update object position utilities from object-{side}-{side} to object-{top/bottom}-{left/right} format.

Release Summary

This release introduces several new variants and utilities including text-shadow and mask support, while refining the @source directive behavior and ignoring node_modules by default.

Need More Details?

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

View Full Changelog