tailwind

Migrate Tailwind v3 projects to v4 using CSS-first @theme tokens without tailwind .config.js.

3|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/helpermedia/AppWaffle --skill tailwind-helpermedia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind
Source: https://github.com/helpermedia/AppWaffle/tree/main/.claude/skills/tailwind
Command: npx skills add https://github.com/helpermedia/AppWaffle --skill tailwind-helpermedia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tailwind v4 introduces a CSS-first approach with design tokens, eliminating the need for a JavaScript-based tailwind.config.js; this skill helps teams migrate and standardize styling practices, reducing configuration drift and speeding up design-to-dev handoffs.

Core Features & Use Cases

  • CSS-first configuration with design tokens via @theme to centralize styling decisions.
  • Use cn() for robust, conflict-resolving class merging and conditional styling.
  • Adopt modern Tailwind v4 features (container queries, 3D transforms, wide gamut colors, subgrid) and semantic color naming for scalable design systems.
  • Provide a migration blueprint from Tailwind v3 to v4, covering theming, dark mode, responsive patterns, and best practices for maintenance.

Quick Start

Use the tailwind skill to extract all text from the attached file 'invoice-q3.pdf'.

Frequently Asked Questions about tailwind

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from Tailwind v3 to v4 using CSS-first design tokens?

To migrate from Tailwind v3 to v4, transition your configuration to a CSS-first approach using the @theme directive for design tokens, eliminating the JavaScript-based tailwind.config.js and adopting semantic color naming.

What is the best way to manage Tailwind v4 theming and dark mode without a config file?

The best way to manage Tailwind v4 theming and dark mode without a config file is by centralizing styling decisions through CSS-first design tokens defined via the @theme directive, ensuring consistent utility usage across frontend workflows.

Does Tailwind v4 support responsive design and container queries out of the box?

Yes, Tailwind v4 supports responsive design and modern features like container queries, 3D transforms, wide gamut colors, and subgrid directly through its CSS-first utility approach without requiring JavaScript configuration.

How do I resolve conflicting Tailwind utility classes during component migration?

You can resolve conflicting Tailwind utility classes during component migration by using the cn() function, which provides robust, conflict-resolving class merging and supports conditional styling for complex frontend workflows.

Why should I remove tailwind.config.js when upgrading to Tailwind v4?

You should remove tailwind.config.js when upgrading to Tailwind v4 to adopt the CSS-first design tokens approach, which reduces configuration drift, centralizes styling decisions via @theme, and speeds up design-to-dev handoffs.

What are the limitations of using a CSS-first approach for Tailwind design tokens?

A limitation of the CSS-first approach for Tailwind design tokens is that teams must adapt existing v3 workflows, requiring a comprehensive migration blueprint to properly restructure theming, dark mode, and responsive patterns without the familiar JavaScript configuration.