1---2name: 050103-tailwind-implement3description: Tailwind CSS v4 CSS-first configuration and shadcn/ui component composition — CVA factories, styling rules, forms, icons, Base vs Radix API.4license: MIT5---67# Tailwind CSS v4 & shadcn/ui Composition89Implementation layer of frontend design — translating design tokens into `@theme` blocks and composing shadcn/components following the component system rules.1011## References1213| Topic | File |14|---|---|15| Tailwind v4: `@theme`, `@custom-variant`, `@utility`, `@starting-style`, container queries, CVA patterns, v3→v4 migration | [references/tailwind-v4.md](references/tailwind-v4.md) |16| shadcn styling: semantic colors, gap-*, size-*, truncate, cn(), no dark: overrides, no z-index on overlays | [references/shadcn-styling.md](references/shadcn-styling.md) |17| shadcn forms: FieldGroup/Field, InputGroup, ToggleGroup, FieldSet, validation states | [references/shadcn-forms.md](references/shadcn-forms.md) |18| shadcn composition: Card, Empty, Alert, sonner toast, Dialog/Sheet/Drawer Title, Button loading, Tabs, Avatar, Separator, Skeleton, Badge | [references/shadcn-composition.md](references/shadcn-composition.md) |19| shadcn icons: data-icon, no sizing, pass as objects, stroke consistency, no emoji | [references/shadcn-icons.md](references/shadcn-icons.md) |20| Base vs Radix API: asChild vs render, Select, Accordion, Slider, ToggleGroup differences | [references/shadcn-base-radix.md](references/shadcn-base-radix.md) |21| Data Table with TanStack: column defs, sorting, filtering, pagination, row selection, visibility | [references/shadcn-data-table.md](references/shadcn-data-table.md) |22| Charts with Recharts: ChartContainer, bar/line/area/pie/radial, tooltip, legend | [references/shadcn-charts.md](references/shadcn-charts.md) |2324## When to Use2526| Trigger | Use |27|---|---|28| Setting up Tailwind v4 theme | [references/tailwind-v4.md](references/tailwind-v4.md) |29| Building form UI | [references/shadcn-forms.md](references/shadcn-forms.md) |30| Composing Card/Dialog/Sheet | [references/shadcn-composition.md](references/shadcn-composition.md) |31| Placing icons in buttons | [references/shadcn-icons.md](references/shadcn-icons.md) |32| Deciding asChild vs render | [references/shadcn-base-radix.md](references/shadcn-base-radix.md) |33| Using semantic colors correctly | [references/shadcn-styling.md](references/shadcn-styling.md) |34| Building a data table with TanStack | [references/shadcn-data-table.md](references/shadcn-data-table.md) |35| Building charts with Recharts | [references/shadcn-charts.md](references/shadcn-charts.md) |