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.