Tailwind 4.1+

Setup

@import "tailwindcss";

Required Reading

Before writing any @theme or @utility → READ utilities.md and examples/*.css

Avoid → Use

• tailwind.config.js → @theme in CSS
• @apply → @utility or raw CSS
• dark:bg-* per element → semantic tokens (see patterns.md)
• group class → in-* variant (see variants.md)
• bg-gradient-to-* → bg-linear-to-*

Patterns

• Dark mode: :root/.dark + @theme inline → patterns.md
• Variants: in-*, has-*, nth-*, negation → variants.md
• Container queries: @container, @sm:, @md: → variants.md
• Entry animation: starting: variant → patterns.md
• Masks: mask-b-from-*, mask-radial-* → patterns.md
• Project utilities: check styles/base/utilities.css