secondsky/claude-skills / plugins/tailwind-v4-shadcn/skills/tailwind-v4-shadcn
tailwind-v4-shadcn
Verified| Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React. Use when: initializing React projects with Tailwind v4, setting up shadcn/ui, implementing dark mode, debugging CSS variable issues, fixing theme switching, migrating from Tailwind v3, or encountering color/theming problems. Covers: @theme inline pattern, CSS variable architecture, dark mode with ThemeProvider, component composition, vite.config setup, common v4 gotchas, and production-tested patterns.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.5 KB |
| references/advanced-usage.md | markdown | 3.6 KB |
| references/common-gotchas.md | markdown | 7.4 KB |
| references/dark-mode.md | markdown | 5.3 KB |
| references/migration-guide.md | markdown | 6.8 KB |
| references/plugins-reference.md | markdown | 3.1 KB |
| templates/components.json | config | 396 B |
| templates/index.css | other | 4.5 KB |
| templates/theme-provider.tsx | other | 2.2 KB |
| templates/tsconfig.app.json | config | 719 B |
| templates/utils.ts | script | 166 B |
| templates/vite.config.ts | script | 337 B |
references/plugins-reference.md
View on GitHub# Tailwind v4 Plugins Reference
**Purpose**: Complete guide to Tailwind v4 official plugins (Typography, Forms)
**When to Load**: User mentions prose class, Typography plugin, Forms plugin, @plugin directive, or plugin installation errors
---
## Overview
Tailwind v4 supports official plugins using the `@plugin` directive in CSS (not the v3 config file approach).
---
## Official Plugins (Tailwind Labs)
### Typography Plugin - Style Markdown/CMS Content
**When to use:** Displaying blog posts, documentation, or any HTML from Markdown/CMS.
**Installation:**
```bash
bun add -d @tailwindcss/typography
# or: npm install -D @tailwindcss/typography
```
**Configuration (v4 syntax):**
```css
/* src/index.css */
@import "tailwindcss";
@plugin "@tailwindcss/typography";
```
**Usage:**
```html
<article class="prose lg:prose-xl dark:prose-invert">
{{ markdown_content }}
</article>
```
**Available classes:**
- `prose` - Base typography styles
- `prose-sm`, `prose-base`, `prose-lg`, `prose-xl`, `prose-2xl` - Size variants
- `dark:prose-invert` - Dark mode styles
---
### Forms Plugin - Reset Form Element Styles
**When to use:** Building custom forms without shadcn/ui components, or need consistent cross-browser form styling.
**Installation:**
```bash
bun add -d @tailwindcss/forms
# or: npm install -D @tailwindcss/forms
```
**Configuration (v4 syntax):**
```css
/* src/index.css */
@import "tailwindcss";
@plugin "@tailwindcss/forms";
```
**What it does:**
- Resets browser default form styles
- Makes form elements styleable with Tailwind utilities
- Fixes cross-browser inconsistencies for inputs, selects, checkboxes, radios
**Note:** Less critical for shadcn/ui users (they have pre-styled form components), but still useful for basic forms.
---
## Common Plugin Errors
These errors happen when using v3 syntax in v4 projects:
### Error 1: Using v3 config file syntax
**❌ WRONG (v3 config file syntax):**
```js
// tailwind.config.js
module.exports = {
plugins: [require('@tailwindcss/typography')]
}
```
**Why it fails**: Tailwind v4 doesn't use `tailwind.config.js` for plugins.
**✅ CORRECT (v4 @plugin directive):**
```css
/* src/index.css */
@import "tailwindcss";
@plugin "@tailwindcss/typography";
```
---
### Error 2: Using @import instead of @plugin
**❌ WRONG (@import instead of @plugin):**
```css
@import "@tailwindcss/typography"; /* Doesn't work */
```
**Why it fails**: Plugins must be loaded with `@plugin`, not `@import`.
**✅ CORRECT:**
```css
@import "tailwindcss";
@plugin "@tailwindcss/typography";
@plugin "@tailwindcss/forms";
```
---
## Multiple Plugins
Load multiple plugins by adding multiple `@plugin` directives:
```css
/* src/index.css */
@import "tailwindcss";
@plugin "@tailwindcss/typography";
@plugin "@tailwindcss/forms";
```
**Order matters**: Import tailwindcss first, then plugins.
---
## Official Documentation
- Typography: https://tailwindcss.com/docs/typography-plugin
- Forms: https://tailwindcss.com/docs/plugins#official-plugins
- Tailwind v4 Plugin System: https://tailwindcss.com/blog/tailwindcss-v4-beta#css-first-configuration
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |