--- id: tailwind-integration title: Tailwind CSS Integration --- _So you want to use Tailwind CSS in your TanStack Start project?_ This guide will help you use Tailwind CSS in your TanStack Start project. ## Tailwind CSS Version 4 (Latest) The latest version of Tailwind CSS is 4. And it has some configuration changes that majorly differ from Tailwind CSS Version 3. It's **easier and recommended** to set up Tailwind CSS Version 4 in a TanStack Start project, as TanStack Start uses Vite as its build tool. ### Install Tailwind CSS Install Tailwind CSS and it's Vite plugin. ```shell npm install tailwindcss @tailwindcss/vite ``` ### Configure The Vite Plugin Add the `@tailwindcss/vite` plugin to your Vite configuration. ```ts // vite.config.ts import { defineConfig } from 'vite' import tsConfigPaths from 'vite-tsconfig-paths' import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import tailwindcss from '@tailwindcss/vite' import viteSolid from 'vite-plugin-solid' export default defineConfig({ server: { port: 3000, }, plugins: [ tsConfigPaths(), tanstackStart(), viteSolid({ ssr: true }), tailwindcss(), ], }) ``` ### Import Tailwind in your CSS file You need to create a CSS file to configure Tailwind CSS instead of the configuration file in version 4. You can do this by creating a `src/styles/app.css` file or name it whatever you want. ```css /* src/styles/app.css */ @import 'tailwindcss' source('../'); ``` ## Import the CSS file in your `__root.tsx` file Import the CSS file in your `__root.tsx` file with the `?url` query and make sure to add the **triple slash** directive to the top of the file. ```tsx // src/routes/__root.tsx /// // other imports... import appCss from '../styles/app.css?url' export const Route = createRootRoute({ head: () => ({ meta: [ // your meta tags and site config ], links: [{ rel: 'stylesheet', href: appCss }], // other head config }), component: RootComponent, }) ``` ## Use Tailwind CSS anywhere in your project You can now use Tailwind CSS anywhere in your project. ```tsx // src/routes/index.tsx import { createFileRoute } from '@tanstack/solid-router' export const Route = createFileRoute('/')({ component: Home, }) function Home() { return
Hello World
} ``` That's it! You can now use Tailwind CSS anywhere in your project 🎉. ## Tailwind CSS Version 3 (Legacy) If you are want to use Tailwind CSS Version 3, you can use the following steps. ### Install Tailwind CSS Install Tailwind CSS and it's peer dependencies. ```shell npm install -D tailwindcss@3 postcss autoprefixer ``` Then generate the Tailwind and PostCSS configuration files. ```shell npx tailwindcss init -p ``` ### Configure your template paths Add the paths to all of your template files in the `tailwind.config.js` file. ```js // tailwind.config.js /** @type {import('tailwindcss').Config} */ export default { content: ['./src/**/*.{js,ts,jsx,tsx}'], theme: { extend: {}, }, plugins: [], } ``` ### Add the Tailwind directives to your CSS file Add the `@tailwind` directives for each of Tailwind's layers to your `src/styles/app.css` file. ```css /* src/styles/app.css */ @tailwind base; @tailwind components; @tailwind utilities; ``` > [!NOTE] > Jump to [Import the CSS file in your `__root.tsx` file](#import-the-css-file-in-your-__roottsx-file) to see how to import the CSS file in your `__root.tsx` file.