1---2name: tailwindcss3description: Tailwind CSS utility-first CSS framework. Use when styling web applications with utility classes, building responsive designs, or customizing design systems with theme variables.4---5
6# Tailwind CSS
7
8> The skill is based on Tailwind CSS v4.1.18, generated at 2026-01-28.
9
10Tailwind CSS is a utility-first CSS framework for rapidly building custom user interfaces. Instead of writing custom CSS, you compose designs using utility classes directly in your markup. Tailwind v4 introduces CSS-first configuration with theme variables, making it easier to customize your design system.
11
12## Core References
13
14| Topic | Description | Reference |
15|-------|-------------|-----------|
16| Installation | Vite, PostCSS, CLI, and CDN setup | [core-installation](references/core-installation.md) |
17| Utility Classes | Understanding Tailwind's utility-first approach and styling elements | [core-utility-classes](references/core-utility-classes.md) |
18| Theme Variables | Design tokens, customizing theme, and theme variable namespaces | [core-theme](references/core-theme.md) |
19| Responsive Design | Mobile-first breakpoints, responsive variants, and container queries | [core-responsive](references/core-responsive.md) |
20| Variants | Applying utilities conditionally with state, pseudo-class, and media query variants | [core-variants](references/core-variants.md) |
21| Preflight | Tailwind's base styles and how to extend or disable them | [core-preflight](references/core-preflight.md) |
22
23## Layout
24
25### Display & Flexbox & Grid
26
27| Topic | Description | Reference |
28|-------|-------------|-----------|
29| Display | flex, grid, block, inline, hidden, sr-only, flow-root, contents | [layout-display](references/layout-display.md) |
30| Flexbox | flex-direction, justify, items, gap, grow, shrink, wrap, order | [layout-flexbox](references/layout-flexbox.md) |
31| Grid | grid-cols, grid-rows, gap, place-items, col-span, row-span, subgrid | [layout-grid](references/layout-grid.md) |
32| Aspect Ratio | Controlling element aspect ratio for responsive media | [layout-aspect-ratio](references/layout-aspect-ratio.md) |
33| Columns | Multi-column layout for magazine-style or masonry layouts | [layout-columns](references/layout-columns.md) |
34
35### Positioning
36
37| Topic | Description | Reference |
38|-------|-------------|-----------|
39| Position | Controlling element positioning with static, relative, absolute, fixed, and sticky | [layout-position](references/layout-position.md) |
40| Inset | Controlling placement of positioned elements with top, right, bottom, left, and inset utilities | [layout-inset](references/layout-inset.md) |
41
42### Sizing
43
44| Topic | Description | Reference |
45|-------|-------------|-----------|
46| Width | Setting element width with spacing scale, fractions, container sizes, and viewport units | [layout-width](references/layout-width.md) |
47| Height | Setting element height with spacing scale, fractions, viewport units, and content-based sizing | [layout-height](references/layout-height.md) |
48| Min & Max Sizing | min-width, max-width, min-height, max-height constraints | [layout-min-max-sizing](references/layout-min-max-sizing.md) |
49
50### Spacing
51
52| Topic | Description | Reference |
53|-------|-------------|-----------|
54| Margin | Controlling element margins with spacing scale, negative values, logical properties, and space utilities | [layout-margin](references/layout-margin.md) |
55| Padding | Controlling element padding with spacing scale, logical properties, and directional utilities | [layout-padding](references/layout-padding.md) |
56
57### Overflow
58
59| Topic | Description | Reference |
60|-------|-------------|-----------|
61| Overflow | Controlling how elements handle content that overflows their container | [layout-overflow](references/layout-overflow.md) |
62
63### Images & Replaced Elements
64
65| Topic | Description | Reference |
66|-------|-------------|-----------|
67| Object Fit & Position | Controlling how images and video are resized and positioned | [layout-object-fit-position](references/layout-object-fit-position.md) |
68
69### Tables
70
71| Topic | Description | Reference |
72|-------|-------------|-----------|
73| Table Layout | border-collapse, table-auto, table-fixed | [layout-tables](references/layout-tables.md) |
74
75## Transforms
76
77| Topic | Description | Reference |
78|-------|-------------|-----------|
79| Transform Base | Base transform utilities for enabling transforms, hardware acceleration, and custom transform values | [transform-base](references/transform-base.md) |
80| Translate | Translating elements on x, y, and z axes with spacing scale, percentages, and custom values | [transform-translate](references/transform-translate.md) |
81| Rotate | Rotating elements in 2D and 3D space with degree values and custom rotations | [transform-rotate](references/transform-rotate.md) |
82| Scale | Scaling elements uniformly or on specific axes with percentage values | [transform-scale](references/transform-scale.md) |
83| Skew | Skewing elements on x and y axes with degree values | [transform-skew](references/transform-skew.md) |
84
85## Typography
86
87| Topic | Description | Reference |
88|-------|-------------|-----------|
89| Font & Text | Font size, weight, color, line-height, letter-spacing, decoration, truncate | [typography-font-text](references/typography-font-text.md) |
90| Text Align | Controlling text alignment with left, center, right, justify, and logical properties | [typography-text-align](references/typography-text-align.md) |
91| List Style | list-style-type, list-style-position for bullets and markers | [typography-list-style](references/typography-list-style.md) |
92
93## Visual
94
95| Topic | Description | Reference |
96|-------|-------------|-----------|
97| Background | Background color, gradient, image, size, position | [visual-background](references/visual-background.md) |
98| Border | Border width, color, radius, divide, ring | [visual-border](references/visual-border.md) |
99| Effects | Box shadow, opacity, mix-blend, backdrop-blur, filter | [visual-effects](references/visual-effects.md) |
100| SVG | fill, stroke, stroke-width for SVG and icon styling | [visual-svg](references/visual-svg.md) |
101
102## Effects & Interactivity
103
104| Topic | Description | Reference |
105|-------|-------------|-----------|
106| Transition & Animation | CSS transitions, animation keyframes, reduced motion | [effects-transition-animation](references/effects-transition-animation.md) |
107| Visibility & Interactivity | Visibility, cursor, pointer-events, user-select, z-index | [effects-visibility-interactivity](references/effects-visibility-interactivity.md) |
108| Form Controls | accent-color, appearance, caret-color, resize | [effects-form-controls](references/effects-form-controls.md) |
109| Scroll Snap | scroll-snap-type, scroll-snap-align for carousels | [effects-scroll-snap](references/effects-scroll-snap.md) |
110
111## Features
112
113### Dark Mode
114
115| Topic | Description | Reference |
116|-------|-------------|-----------|
117| Dark Mode | Implementing dark mode with the dark variant and custom strategies | [features-dark-mode](references/features-dark-mode.md) |
118
119### Migration
120
121| Topic | Description | Reference |
122|-------|-------------|-----------|
123| Upgrade Guide | Migrating from v3 to v4, breaking changes, rename mappings | [features-upgrade](references/features-upgrade.md) |
124
125### Customization
126
127| Topic | Description | Reference |
128|-------|-------------|-----------|
129| Custom Styles | Adding custom styles, utilities, variants, and working with arbitrary values | [features-custom-styles](references/features-custom-styles.md) |
130| Functions & Directives | Tailwind's CSS directives and functions for working with your design system | [features-functions-directives](references/features-functions-directives.md) |
131| Content Detection | How Tailwind detects classes and how to customize content scanning | [features-content-detection](references/features-content-detection.md) |
132
133## Best Practices
134
135| Topic | Description | Reference |
136|-------|-------------|-----------|
137| Utility Patterns | Managing duplication, conflicts, important modifier, when to use components | [best-practices-utility-patterns](references/best-practices-utility-patterns.md) |
138
139## Key Recommendations
140
141- **Use utility classes directly in markup** - Compose designs by combining utilities
142- **Customize with theme variables** - Use `@theme` directive to define design tokens
143- **Mobile-first responsive design** - Use unprefixed utilities for mobile, prefixed for breakpoints
144- **Use complete class names** - Never construct classes dynamically with string interpolation
145- **Leverage variants** - Stack variants for complex conditional styling
146- **Prefer CSS-first configuration** - Use `@theme`, `@utility`, and `@custom-variant` over JavaScript configs
aAAaqwq