shadcn-ui

Configure Tailwind v4 and shadcn/ui with CSS-first theming and dark mode.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nubler-hq/tiny --skill shadcn-ui-nubler-hq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadcn-ui
Source: https://github.com/nubler-hq/tiny/tree/main/.github/skills/shadcn-ui
Command: npx skills add https://github.com/nubler-hq/tiny --skill shadcn-ui-nubler-hq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to configuring Tailwind v4 + shadcn/ui projects using a CSS-first theming architecture with semantic variables and an automatic dark mode.

Core Features & Use Cases

  • Four-step architecture ensures reliable theming: root CSS variables, @theme inline mapping, unlayered base styles, and automatic dark mode.
  • Simplifies migration from v3 to v4 by eliminating tailwind.config.ts and embracing a CSS-first workflow.
  • Includes practical references for architecture, dark mode, and migration, reducing common setup pitfalls in React + Vite projects.

Quick Start

To begin, install Tailwind v4 and shadcn/ui, initialize shadcn, configure the components.json, implement a ThemeProvider, and wrap your app entry point with the provider.

Frequently Asked Questions about shadcn-ui

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

FAQPage Schema
How do I migrate Tailwind v3 to v4 with shadcn/ui in a Vite project?

To migrate Tailwind v3 to v4, this skill eliminates tailwind.config.ts and adopts a CSS-first workflow using semantic CSS variables and a four-step architecture, ensuring consistent theming across your React and Vite environment.

What is the best way to set up dark mode in Tailwind v4 and shadcn/ui?

Dark mode in Tailwind v4 and shadcn/ui is configured using an automatic dark mode approach within a CSS-first theming architecture, employing semantic CSS variables and a ThemeProvider pattern to ensure predictable styling transitions.

Does shadcn/ui work with Tailwind v4 CSS-first theming and Vite?

Yes, shadcn/ui works with Tailwind v4 in Vite environments by utilizing a CSS-first theming approach, mapping root CSS variables through @theme inline, and applying unlayered base styles for reliable UI configuration.

How do I configure semantic CSS variables for Tailwind v4 theming?

Configuring semantic CSS variables for Tailwind v4 involves a four-step architecture: defining root CSS variables, mapping them via @theme inline, applying unlayered base styles, and enabling automatic dark mode for consistent UI theming.

Why do I need a ThemeProvider pattern for shadcn/ui dark mode?

A ThemeProvider pattern is required for shadcn/ui dark mode to enforce the four-step theming architecture and ensure consistent UI theming, wrapping your React app entry point to manage predictable styling and automatic dark mode transitions.

What are the limitations of CSS-first theming in Tailwind v4 migrations?

The primary limitation of CSS-first theming in Tailwind v4 migrations is the required elimination of tailwind.config.ts, meaning previous JavaScript-based configuration logic must be fully translated into semantic CSS variables and @theme inline mappings.