Tailwind v4 + shadcn/ui Production Stack

1. Install Tailwind CSS and related dependencies using `pnpm add tailwindcss @tailwindcss/vite` and `pnpm add -D @types/node tw-animate-css`.

2. Initialize shadcn/ui with `pnpm dlx shadcn@latest init`.

3. Configure `vite.config.ts` to include Tailwind CSS plugin and resolve aliases.

4. Define CSS variables at the root level in `src/index.css` using `hsl()` wrappers.

5. Map CSS variables to Tailwind utilities using `@theme inline`.

6. Apply base styles within the `@layer base` block, referencing variables directly.

7. Set up dark mode using ThemeProvider and a theme toggle component.

8. Address common errors by following the provided solutions.