tailwind-theme-builder

Installation
Summary

Tailwind v4 and shadcn/ui setup with CSS variables, dark mode, and semantic color theming.

  • Automates dependency installation, Vite configuration with the Tailwind plugin, and shadcn/ui initialization
  • Implements a mandatory four-step CSS architecture: root CSS variables, @theme inline mapping, base styles, and dark mode via class switching
  • Includes pre-built theme provider component for dark mode toggling and persistent theme storage
  • Provides troubleshooting guides for common v4 migration issues: @apply breaking changes, double hsl() wrapping, missing @theme blocks, and tw-animate-css errors
SKILL.md

Tailwind Theme Builder

Set up a fully themed Tailwind v4 + shadcn/ui project with dark mode. Produces configured CSS, theme provider, and working component library.

Architecture: The Four-Step Pattern

Tailwind v4 requires a specific architecture for CSS variable-based theming. This pattern is mandatory -- skipping or modifying steps breaks the theme.

How It Works

CSS Variable Definition --> @theme inline Mapping --> Tailwind Utility Class
--background           --> --color-background     --> bg-background
(with hsl() wrapper)      (references variable)     (generated class)

Dark mode switching:

ThemeProvider toggles .dark class on <html>
Related skills
Installs
2.2K
GitHub Stars
776
First Seen
Feb 18, 2026