tailwind-v4-shadcn

Configure Tailwind v4 and shadcn/ui theming with CSS variables for React and Vite projects.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/GofiveCorp/pegasussio --skill tailwind-v4-shadcn-gofivecorp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind-v4-shadcn
Source: https://github.com/GofiveCorp/pegasussio/tree/main/.agent/skills/tailwind-v4-shadcn
Command: npx skills add https://github.com/GofiveCorp/pegasussio --skill tailwind-v4-shadcn-gofivecorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill streamlines the setup of Tailwind v4 with shadcn/ui, providing a robust theming architecture based on CSS variables and a built-in dark mode workflow.

Core Features & Use Cases

  • 4-step theming pattern: root CSS variables, @theme inline mappings, base styles, and automatic dark mode.
  • Dark mode ready: ThemeProvider integration to toggle light/dark/system themes with persistence.
  • Migration-safe templates: Ready-to-copy templates and reference docs for quick project bootstrap.
  • Use Case: Initialize a new React project with Tailwind v4 and shadcn/ui, ensuring semantic colors and consistent theming across components.

Quick Start

Follow the quick start steps to install dependencies, configure Vite with tailwind v4 and shadcn/ui, run the shadcn init, and wrap your app with a ThemeProvider.

Frequently Asked Questions about tailwind-v4-shadcn

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

FAQPage Schema
How do I set up Tailwind v4 with shadcn/ui theming in React?

To set up Tailwind v4 with shadcn/ui theming, you wire CSS variables to Tailwind utilities using a four-step architecture: root variables, @theme inline mappings, base styles, and dark mode. This applies to React and Vite projects.

What is the best way to configure dark mode with Tailwind v4 and shadcn/ui?

The best way to configure dark mode involves integrating a ThemeProvider to toggle light, dark, and system themes with persistence. This dark mode workflow relies on mapping root CSS variables to Tailwind utilities.

Does shadcn/ui work with Tailwind v4 CSS-first configuration?

Yes, shadcn/ui works with Tailwind v4 by enforcing a CSS-first configuration. This approach prevents common v3 mistakes by applying a four-step architecture that maps semantic colors directly via CSS variables.

How do I map CSS variables to Tailwind utilities for semantic colors?

You map CSS variables to Tailwind utilities using the @theme inline directive. This step is part of a four-step theming pattern that ensures consistent semantic colors across your React components.

Why are my Tailwind v3 theming configurations breaking in shadcn/ui?

Tailwind v3 configurations break because Tailwind v4 enforces a CSS-first configuration and a specific four-step architecture. Applying the v3 approach causes mistakes; you must wire root CSS variables and @theme inline mappings instead.

Can I use Tailwind v4 and shadcn/ui templates to bootstrap a Vite project?

Yes, you can bootstrap a Vite project using migration-safe, ready-to-copy templates. These templates provide the necessary reference docs to quickly initialize semantic colors and a built-in dark mode workflow.