tailwind-design-system

Builds component libraries and design tokens using Tailwind CSS v4 CSS-first configuration.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/412181-HerediaLara/ScaffoldingBE-FE --skill tailwind-design-system-412181-heredialara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind-design-system
Source: https://github.com/412181-HerediaLara/ScaffoldingBE-FE/tree/main/FE/.agents/skills/tailwind-design-system
Command: npx skills add https://github.com/412181-HerediaLara/ScaffoldingBE-FE --skill tailwind-design-system-412181-heredialara

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 misconfigurations and inconsistent styling. ## Core Features & Use Cases - CSS-first theming with @theme: Define semantic color tokens in OKLCH, radius scales, and animation keyframes directly in CSS, including dark mode overrides via @custom-variant. - Component patterns: Implement CVA-based variant components (Button, Card, Input, Grid) with React 19 ref-as-prop conventions and accessible form handling. - Advanced v4 capabilities: Use @utility custom utilities, @theme inline/static modifiers, color-mix() alpha scales, container queries, and native popover animations with @starting-style. - Use Case: When migrating a React 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: import Tailwind with @import "tailwindcss" and define your theme inside an @theme block using CSS variables like --color-primary. JavaScript config files are replaced entirely by this approach.

How to set up dark mode in Tailwind CSS v4?

Define a custom variant with @custom-variant dark (&:where(.dark, .dark *)) and override your CSS variables inside a .dark class. A ThemeProvider toggles the class on the document root and persists the choice in localStorage.

What changed from Tailwind v3 to v4?

Key changes include replacing tailwind.config.ts with @theme blocks, @tailwind directives with @import "tailwindcss", class-based darkMode config with @custom-variant, and plugin animations with native CSS @keyframes. The skill includes a 10-item migration checklist.

Does Tailwind v4 work with React 19 forwardRef?

React 19 passes ref as a regular prop, so forwardRef is no longer needed. Component patterns in this skill accept ref directly as an optional prop, simplifying component definitions like Button and Card.

How do I create custom utilities in Tailwind v4?

Use the @utility directive in CSS to define reusable custom utilities, such as decorative lines or text gradients, composing existing Tailwind classes with @apply. This replaces v3 plugin-based utility registration.