Skip to content

feat: upgrade tailwindcss to v4 - #34

Merged
kahlstrm merged 1 commit into
mainfrom
chore/tailwind-4
Aug 3, 2026
Merged

kahlstrm merged 1 commit into
mainfrom
chore/tailwind-4

Conversation

@kahlstrm

@kahlstrm kahlstrm commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Summary

tailwindcss 3.3.3 -> 4.3.3, via the official @tailwindcss/upgrade codemod.

  • tailwind.config.ts deleted — the theme now lives in @theme inside app/globals.css
  • @tailwind base/components/utilities -> @import 'tailwindcss'
  • postcss.config.js -> @tailwindcss/postcss
  • autoprefixer removed — v4 handles prefixing itself
  • tailwindcss-animate kept, loaded via @plugin

Verification

The visual surface has no automated coverage — the e2e suite asserts status codes and headers,
not styles — and the styled page sits behind Clerk auth, so screenshots cannot reach it. So
rather than rely on "it builds", I compared the compiled CSS before and after: every
utility the source uses, checked against the emitted bundle.

107 utilities identical. 11 changed — each a documented v4 rename with a 1:1 counterpart:

Before After Why
focus-visible:outline-none focus-visible:outline-hidden outline-none changed meaning in v4
focus:outline-none focus:outline-hidden same
shadow shadow-xs shadow scale renamed, so this preserves appearance
z-[100] z-100 now a built-in rather than an arbitrary value
group-[.destructive]:hover:* hover:group-[.destructive]:* variant order changed (4 rules)
group-[.destructive]:focus:* focus:group-[.destructive]:* same (3 rules)

Nothing was silently dropped — no utility lost its rule without a renamed equivalent.

The publicly reachable styled page also renders byte-identically: screenshots of /sign-in
before and after share the same SHA-256 (df43cae23aac967c…).

What is still unverified

The authenticated / page — UrlForm, UrlList, the table, buttons and toasts — is where most
Tailwind classes actually render, and no automated check reaches it. The CSS comparison covers
those utilities at the stylesheet level, but nobody has looked at the rendered page.

Worth clicking through the preview signed in before merging.

Testing

  • pnpm build — compiles
  • pnpm test:unit — 18 passed
  • pnpm test:e2e — 9 passed
  • pnpm lint / pnpm format:check — clean

@vercel

vercel Bot commented Aug 3, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
next-shortener Ready Ready Preview Aug 3, 2026 4:55pm

@kahlstrm
kahlstrm merged commit db1a57f into main Aug 3, 2026
4 checks passed
@kahlstrm
kahlstrm deleted the chore/tailwind-4 branch August 3, 2026 16:57

This branch was successfully deployed

1 active deployment
Preview — ae82c670 Deployed Aug 3, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant