tailwind-ui

Tailwind CSS v4.1 best practices with WCAG 2.1 AA accessibility, theming, and dark mode support. Use when working with HTML, CSS, styling components, accessibility (a11y), WCAG compliance, color contrast, focus states, screen readers, theming, light mode, dark mode, or building accessible UI patterns like buttons, forms, cards, and navigation. Complements the angular-best-practices skill for Angular frontends.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill optimizes Tailwind CSS v4.1 development by integrating WCAG 2.1 AA accessibility standards, advanced theming, and dark mode support. It ensures high-quality UI implementation with modern CSS patterns, helping developers build inclusive, performant, and maintainable web interfaces while adhering to the latest framework updates and breaking changes.

Use Cases

  • Migrating legacy Tailwind CSS projects to v4.1 by automatically replacing deprecated utilities like bg-opacity or space-x with modern alternatives like opacity modifiers and gap utilities.
  • Building WCAG 2.1 AA compliant UI components such as accessible forms, buttons, and navigation systems with proper color contrast and focus states.
  • Implementing complex design systems and multi-theme support using the new Tailwind v4 @theme directive and CSS variables for light and dark modes.
  • Refactoring frontend code to adopt modern CSS best practices, including dynamic viewport heights (dvh), size utilities, and line-height modifiers for better responsive design.
nametailwind-ui
descriptionTailwind CSS v4.1 best practices with WCAG 2.1 AA accessibility, theming, and dark mode support. Use when working with HTML, CSS, styling components, accessibility (a11y), WCAG compliance, color contrast, focus states, screen readers, theming, light mode, dark mode, or building accessible UI patterns like buttons, forms, cards, and navigation. Complements the angular-best-practices skill for Angular frontends.

Tailwind UI Skill

Tailwind CSS v4.1 development with accessibility and theming baked in.

Quick Reference

v4.1 Critical Changes

Never use deprecated utilities — always use replacements:

Deprecated Replacement
bg-opacity-* bg-black/50 (opacity modifier)
bg-gradient-* bg-linear-*
shadow-sm shadow-xs
shadow shadow-sm
rounded-sm rounded-xs
rounded rounded-sm
ring ring-3
outline-none outline-hidden
leading-* Use text-base/7 line-height modifiers
flex-shrink-* / flex-grow-* shrink-* / grow-*
space-x-* in flex/grid Use gap-* instead

Essential Patterns

<!-- Gap over space utilities -->
<div class="flex gap-4">...</div>

<!-- Opacity modifiers -->
<div class="bg-primary-500/60">...</div>

<!-- Line height modifiers -->
<p class="text-base/7">...</p>

<!-- Dynamic viewport height (mobile-safe) -->
<div class="min-h-dvh">...</div>

<!-- Size utility for equal dimensions -->
<div class="size-12">...</div>

Reference Files

Load these based on the task:

Theme Asset

Core Principles

  1. Use Tailwind's scale — Avoid arbitrary values like ml-[16px]; use ml-4
  2. Never use @apply — Use CSS variables or framework components
  3. Gap over margins — Use gap-* in flex/grid, not space-* or child margins
  4. Test both modes — Always verify light AND dark mode appearance
  5. Accessibility first — Every interactive element needs visible focus states and proper contrast