1. Installation
  2. 在 TanStack Start 中安裝 Tailwind CSS

Installation

在 TanStack Start 中安裝 Tailwind CSS

在 TanStack Start 專案中設定 Tailwind CSS。

01

建立專案

如果你還沒有設定專案,請先建立一個新的 TanStack Start 專案。最常見的方式是使用 Create Start App

Terminal
npx create-start-app@latest my-projectcd my-project
02

安裝 Tailwind CSS

透過 npm 安裝 @tailwindcss/vite 及其對等相依套件。

Terminal
npm install tailwindcss @tailwindcss/vite
03

設定 Vite 外掛

@tailwindcss/vite 外掛加入你的 Vite 設定。

vite.config.ts
import { tanstackStart } from '@tanstack/react-start/plugin/vite';import { defineConfig } from 'vite';import tsConfigPaths from 'vite-tsconfig-paths';import tailwindcss from '@tailwindcss/vite'export default defineConfig({  plugins: [    tailwindcss()    tanstackStart(),    tsConfigPaths(),  ]});
04

匯入 Tailwind CSS

./src/styles.css 中加入 @import 來匯入 Tailwind CSS。

src/styles.css
@import "tailwindcss";
05

在根路由中匯入 CSS 檔案

在你的 __root.tsx 檔案中使用 ?url 查詢來匯入 CSS 檔案。

src/routes/__root.tsx
// other imports...import appCss from '../styles.css?url'export const Route = createRootRoute({  head: () => ({    meta: [      // your meta tags and site config    ],    links: [{ rel: 'stylesheet', href: appCss }],    // other head config  }),  component: RootComponent,})
06

開始在專案中使用 Tailwind

開始使用 Tailwind 的通用類別來設定內容樣式。

src/routes/index.tsx
import { createFileRoute } from '@tanstack/react-router'export const Route = createFileRoute('/')({  component: App,})function App() {  return (    <h1 class="text-3xl font-bold underline">      Hello World!    </h1>  )}
Copyright © 2026 Tailwind Labs Inc.·商標政策(Brand)