最近チームで Tailwind CSS v4 安定版を導入し、多くの経験を積みました。参考のためにまとめましたので、同様の作業をされている方のお役に立てれば幸いです。

コアコンセプト

以下の方法で改善できます：

:root {
  --bg: light-dark(#fff, #1a1a2e);
  --text: light-dark(#333, #e0e0e0);
  --accent: light-dark(#2563eb, #60a5fa);
  color-scheme: light dark;
}

.carousel {
  display: flex;
  gap: 1rem;
  overflow-x: auto;
  scroll-snap-type: x mandatory;
  scroll-padding: 1rem;
}

.carousel__item {
  flex: 0 0 80%;
  scroll-snap-align: start;
  border-radius: 12px;
  transition: scale 0.3s ease;
}

このソリューションは半年以上にわたって本番環境で安定して稼働しており、実際に検証済みです。

詳細解説

まず基本的な実装方法を見てみましょう：

.container {
  width: min(90%, 1200px);
  margin-inline: auto;
  padding-inline: clamp(1rem, 3vw, 3rem);
}

.grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(300px, 100%), 1fr));
  gap: clamp(1rem, 2vw, 2rem);
}

.card {
  container-type: inline-size;
}

@container (min-width: 400px) {
  .card__content {
    display: grid;
    grid-template-columns: 200px 1fr;
  }
}

このコードは基本的な使い方を示しています。実際のプロジェクトでは、エラーハンドリングやエッジケースも考慮する必要があります。

導入経験

この基盤の上で、さらに最適化できます：

'use client'
import { useChat } from 'ai/react'

export function AIChat() {
  const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({
    api: '/api/chat'
  })
  return (
    <div className="chat-container">
      {messages.map(m => (
        <div key={m.id} className={`message ${m.role}`}>
          <p>{m.content}</p>
        </div>
      ))}
      <form onSubmit={handleSubmit}>
        <input value={input} onChange={handleInputChange} />
        <button type="submit" disabled={isLoading}>送信</button>
      </form>
    </div>
  )
}

このパターンは大規模プロジェクトで非常に実用的で、メンテナンスコストを大幅に削減できます。

チューニング戦略

実際のプロジェクトでの使い方はより複雑になります：

import { openai } from '@ai-sdk/openai'
import { streamText } from 'ai'

export async function POST(req) {
  const { messages } = await req.json()
  const result = await streamText({
    model: openai('gpt-4o'),
    messages,
    system: 'あなたはプロのフロントエンド開発アシスタントです。',
    maxTokens: 2000
  })
  return result.toDataStreamResponse()
}

この方法により、コードのテスタビリティとスケーラビリティが向上します。

注意点