Skip to main content

Notes

Tailwind v4 migration notes

What changed moving from config files to CSS-first tokens, and what we'd do differently.

KoustavJanuary 28, 20265 min readDevelopment

We moved Makershot to Tailwind v4's CSS-first config. Notes from the migration.

What changed

tailwind.config.js@theme inline in globals.css

Plugins configured differently in PostCSS

@import "tailwindcss" replaces @tailwind directives

What we'd do again

Define semantic tokens in :root and .dark before building components. Migrating colors after the fact is painful.

What surprised us

Custom utilities (ds-display, etc.) are easier in v4. Just add classes in CSS with @layer utilities.

Tooling

shadcn v4 works well with the new setup. Run their CLI against the CSS variable mode.

Want this built for you?

Fixed-scope MVP sprints and AI integrations. Same stack as this guide.