fix(deps): migrate Tailwind CSS from v3 to v4#711
Merged
Conversation
6b5e7a9 to
38155ce
Compare
38155ce to
ede1a14
Compare
605809e to
c8c3a4e
Compare
Replace tailwindcss v3 + autoprefixer with @tailwindcss/postcss. Replace tailwindcss-animate with tw-animate-css (pure CSS). Update CSS directives from @tailwind to @import "tailwindcss". Rename shifted utility classes across 83 component files (shadow-sm→shadow-xs, rounded-sm→rounded-xs, outline-none→outline-hidden, backdrop-blur→backdrop-blur-sm).
Migrate from the legacy JS plugins array to the v4-native CSS @plugin directive, which is the recommended approach for Tailwind v4.
Tailwind v4 changed arbitrary value syntax for CSS custom properties: `w-[--sidebar-width]` now generates invalid `width: --sidebar-width` instead of `width: var(--sidebar-width)`. The v4 syntax uses parentheses: `w-(--sidebar-width)`. This was the root cause of all 6 Desktop E2E test failures — the sidebar spacer div rendered at 0px wide, causing the main content to overlap the absolutely-positioned sidebar at z-10.
c8c3a4e to
dd15dc6
Compare
This was referenced May 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
tailwindcssv3 +autoprefixerwith@tailwindcss/postcssv4 in both packages (autoprefixer is now built-in)tailwindcss-animatewithtw-animate-css(pure CSS, not a plugin)@tailwind base/components/utilitiesto@import "tailwindcss"with@configdirectivetailwind.config.js— removecontentarray (v4 auto-detects), removedarkMode: ["class"](v4 handles natively)shadow-sm→shadow-xs,rounded-sm→rounded-xs,outline-none→outline-hidden,backdrop-blur→backdrop-blur-smw-[--sidebar-width]→w-(--sidebar-width),origin-[--radix-*]→origin-(--radix-*)(v4 breaking change — brackets now generate bare--varinstead ofvar(--var))@tailwindcss/typographyv0.5.19 already supports Tailwind v4 — no version change needed