Tailwind CSS v4 Cursor Rules (.mdc) | Free & Offline

Production-grade architectural rulebook for Tailwind CSS v4. Engineered to eliminate LLM hallucinations, enforce strict deterministic conventions, and prevent architectural drift across Cursor IDE, Claude Code CLI, and autonomous multi-agent pipelines.

Target Path
.cursor/rules/tailwind-v4.mdc
Execution Scope
Glob Pattern Auto-Match
Specification Format
Frontmatter MDC (.mdc)
AI Tool Support
Cursor IDE & Composer
02 / DRIFT ANALYSIS & VALUE PROPOSITION

Failure Patterns Prevented for Tailwind CSS v4

Without This Rule (Default LLM Behavior)Vulnerable

Tailwind CSS v4 is an entirely new CSS-first engine that completely replaces javascript-based `tailwind.config.js` with native `@theme` directives in CSS. Outdated LLMs continually hallucinate obsolete tailwind.config.js configurations.

Hallucination Symptoms
  • Invokes deprecated or removed APIs from older model training weights
  • Generates conflicting configuration files and invalid imports
  • Silently drops type-safety, boundaries, or transaction isolation
With This Rule (Guaranteed Invariants)Deterministic
Configure themes directly in globals.css using `@theme` and `@import 'tailwindcss';`.
Never generate or modify legacy `tailwind.config.js` or `tailwind.config.ts` files.
Use CSS custom properties for dynamic color palettes.
Enforce consistent utility ordering: layout -> spacing -> typography -> background -> borders -> interactivity.
03 / VERIFIED CODE PATTERNS

Code Standards: Anti-Pattern vs Verified Implementation

Discouraged Anti-Pattern
// Discouraged in v4: Obsolete tailwind.config.js
module.exports = {
  theme: {
    extend: { colors: { brand: "#f97316" } }
  }
};
Verified Production Standard
@import "tailwindcss";

@theme {
  --color-brand-primary: #f97316;
  --font-display: "Geist Sans", sans-serif;
}
04 / REPOSITORY PLACEMENT & INSTALLATION

Where to Save This Rule in Your Repository

Export the rules from the interactive editor above or download the full ZIP bundle. Ensure the file is placed at the exact path below relative to your project root so the AI engine automatically loads it:

.cursor/rules/tailwind-v4.mdc
05 / ROUTE DIRECTORY & CROSS-TOOLING
Format Pillar HubComprehensive Manual

Cursor Rules (.mdc) Directory & Generator

Inspect the complete specification manual, glob patterns, directory rules, and all available presets in our central directory.

/cursor-rules Directory
06 / FREQUENTLY ASKED QUESTIONS

Technical FAQ: Tailwind CSS v4 AI Rulebooks

Does Tailwind v4 use tailwind.config.js?

No. Tailwind CSS v4 is configured directly in CSS files using the `@theme` directive.