ウェブエンジニア問題集

Tailwind CSSのセットアップ — Next.js・Viteへの導入方法

Tailwind CSS v4 から設定ファイルの仕組みが大きく変わりました。この章ではv4系(2024年以降の標準)のセットアップを中心に説明します。

学習者学習者

ネットの記事だと tailwind.config.js を作れって書いてあるのに、最近作ったプロジェクトには無い…。どっちが正しいの?

先生先生

それはバージョン差だね。v4から設定方法が大きく変わって tailwind.config.js は基本不要になったんだ。古い記事はv3前提のことが多いから注意しよう。

Tailwindをセットアップしているイメージ

Next.jsへの導入(v4)

create-next-app で最初から入れる

npx create-next-app@latest my-app
# "Would you like to use Tailwind CSS?" → Yes

これだけで設定が完了します。

既存プロジェクトへの追加

npm install tailwindcss @tailwindcss/vite

app/globals.css(または styles/globals.css)に追記します。

@import "tailwindcss";

v4 では tailwind.config.js は不要で、CSS の @import だけで有効になります。


Viteへの導入(v4)

npm install tailwindcss @tailwindcss/vite

vite.config.ts にプラグインを追加します。

import { defineConfig } from 'vite'
import tailwindcss from '@tailwindcss/vite'
 
export default defineConfig({
  plugins: [
    tailwindcss(),
  ],
})

src/index.css などのCSSエントリーに追記します。

@import "tailwindcss";

v3系のセットアップ(参考)

v3以前では tailwind.config.js が必要でした。

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p
// tailwind.config.js
module.exports = {
  content: ['./src/**/*.{js,ts,jsx,tsx}'],
  theme: {
    extend: {},
  },
  plugins: [],
}
/* globals.css */
@tailwind base;
@tailwind components;
@tailwind utilities;

VSCode拡張:Tailwind CSS IntelliSense

Tailwindを使うなら必須の拡張機能です。

  • クラス名の補完
  • ホバーでCSSの内容をプレビュー
  • 未知のクラスの警告
拡張機能ID: bradlc.vscode-tailwindcss

ちゃんと使うためのポイント

  • v4は @import "tailwindcss" だけで動く(設定ファイル不要)
  • v3は content の設定を忘れると本番ビルドでスタイルが消える
  • VSCode拡張 Tailwind IntelliSense は実務では必須レベル

次の章では、Flexboxとグリッドのレイアウトユーティリティを学びます。