tailwind-design-system

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

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/TOBIASpuchito/Citec --skill tailwind-design-system-tobiaspuchito
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tailwind-design-system
Source: https://github.com/TOBIASpuchito/Citec/tree/main/citec-frontend/.agents/skills/tailwind-design-system
Command: npx skills add https://github.com/TOBIASpuchito/Citec --skill tailwind-design-system-tobiaspuchito

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. 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 @theme and @custom-variant syntax. ## Core Features & Use Cases - CSS-First Theme Configuration: Define semantic color tokens in OKLCH, radius scales, and animation keyframes inside @theme blocks, with class-based dark mode via @custom-variant. - Component Patterns: Implement CVA-based Button variants, compound Card components, accessible form inputs with error states, and responsive Grid/Container layouts using React 19 ref-as-prop conventions. - Advanced v4 Features: Use native @starting-style popover animations, custom @utility directives, color-mix() alpha scales, namespace overrides, and a complete v3-to-v4 migration checklist. - Use Case: When scaffolding a new component library, apply the provided token hierarchy and CVA patterns to produce a themed Button, Card, and form system with dark mode support in one pass. ## Quick Start Ask the AI to set up a Tailwind CSS v4 design system with semantic color tokens, dark mode, and a CVA-based Button component for your React project.

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 a theme in Tailwind CSS v4?▼

Tailwind v4 replaces tailwind.config.ts with CSS-first configuration using @theme blocks in your stylesheet. Define tokens like --color-primary or --radius-md inside @theme, and they become utilities such as bg-primary automatically.

How to set up dark mode in Tailwind CSS v4?▼

Tailwind v4 uses @custom-variant dark (&:where(.dark, .dark *)) instead of the darkMode config option. Define dark token overrides inside a .dark class block, then toggle the class on the root element with a ThemeProvider.

What changed from Tailwind v3 to v4?▼

Key changes include replacing tailwind.config.ts with @theme blocks, @tailwind directives with @import "tailwindcss", and tailwindcss-animate with native @keyframes inside @theme. The skill includes a 10-item migration checklist covering colors, dark mode, and React 19 ref changes.

Does Tailwind v4 still support tailwind.config.ts?▼

Tailwind v4 is designed around CSS-first configuration with @theme, and this skill recommends against using tailwind.config.ts. For v3 projects, follow the official upgrade guide or the included migration checklist.

How do I create component variants with Tailwind and React?▼

Use class-variance-authority (CVA) to define base styles plus variant and size options, then merge classes with a cn() utility combining clsx and tailwind-merge. In React 19, pass ref as a regular prop instead of using forwardRef.