tailwind-design-system

Build component libraries and design tokens with Tailwind CSS v4 CSS-first configuration.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/achyutkneupane/Blog-Kit --skill tailwind-design-system-achyutkneupane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind-design-system
Source: https://github.com/achyutkneupane/Blog-Kit/tree/main/.ai/skills/tailwind-design-system
Command: npx skills add https://github.com/achyutkneupane/Blog-Kit --skill tailwind-design-system-achyutkneupane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a consistent design system with Tailwind CSS v4 requires learning its new CSS-first configuration model, which differs significantly from v3's JavaScript config approach. This Skill provides ready-to-use patterns for design tokens, component variants, dark mode, and animations so you avoid trial-and-error with the new syntax. ## Core Features & Use Cases - CSS-First Theme Configuration: Define semantic color tokens, radius scales, and animation keyframes using @theme blocks with OKLCH colors and dark mode overrides via @custom-variant. - Component Patterns: Implement CVA-based buttons, compound card components, accessible form inputs, and responsive grid systems in React 19 without forwardRef. - Advanced v4 Features: Use native CSS animations with @starting-style, custom @utility directives, theme modifiers, namespace overrides, and container queries. - Use Case: When migrating a component library from Tailwind v3 to v4, follow the included migration checklist to replace tailwind.config.ts with @theme blocks and swap tailwindcss-animate for native CSS keyframes. ## Quick Start Ask the AI to set up a Tailwind CSS v4 design system with semantic color tokens, dark mode support, and a button component with variants.

Frequently Asked Questions about tailwind-design-system

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

FAQPage Schema
How do I configure Tailwind CSS v4 without tailwind.config.ts?

Tailwind v4 uses CSS-first configuration with @theme blocks in your CSS file instead of tailwind.config.ts. Define tokens like --color-primary inside @theme, and replace @tailwind directives with a single @import "tailwindcss" statement.

How to set up dark mode in Tailwind CSS v4?

Tailwind v4 dark mode uses @custom-variant dark (&:where(.dark, .dark *)) instead of the darkMode: "class" config option. Override your CSS variables inside a .dark selector, and toggle the class on the root element with a theme provider.

What changed from Tailwind v3 to v4 for animations?

Tailwind v4 replaces the tailwindcss-animate plugin with native CSS keyframes defined inside @theme blocks and referenced via --animate-* variables. Entry animations can use the native @starting-style at-rule with allow-discrete transitions.

Does Tailwind v4 work with React 19 components?

Yes, Tailwind v4 pairs with React 19 where ref is passed as a regular prop, eliminating forwardRef. Components use CVA for type-safe variants and the cn utility combining clsx with tailwind-merge for class composition.

Why use OKLCH colors instead of HSL in Tailwind themes?

OKLCH provides better perceptual uniformity than HSL, meaning equal numeric changes produce visually consistent color shifts. Define OKLCH values directly in @theme tokens, and use color-mix() to generate semi-transparent alpha variants.