Communitygithub.com

ダークモード

CSS変数によるテーマ切り替え、システム設定の検出、next-themesと永続化を実現します。

ダークモード とは?

このスキルは、Next.jsアプリケーションにダークモードを実装するためのベストプラクティスを提供します。`next-themes`ライブラリを使用して、システム設定の自動検出、手動切り替え、localStorageへの設定永続化を簡単に実現できます。CSS変数を活用してテーマカラーを定義し、`dark:` Tailwindプレフィックスを使って効率的にスタイルを管理します。また、ハイドレーション時のテーマ不一致を防ぐための`suppressHydrationWarning`の設定や、テーマトグルコンポーネントの実装パターンも含まれています。これにより、ユーザーのシステム設定を尊重しつつ、シームレスで一貫性のあるテーマ切り替え体験を提供できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/dark-mode

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ダークモード は何をしますか?

ルール

  • Next.jsアプリでは next-themes を使用する — アプリを <ThemeProvider attribute="class" defaultTheme="system"> でラップする
  • 色の定義にはCSS変数を使用する — :root(ライト)と .dark(ダーク)に定義し、var(--background) で参照する
  • システム設定の検出: defaultTheme="system" により prefers-color-scheme メディアクエリを尊重する
  • テーマトグルコンポーネント: ライト/ダーク/システムを切り替える — next-themes の useTheme() フックを使用する
  • Tailwind統合: tailwind設定で darkMode: "class" を有効にし、オーバーライドには dark: プレフィックスを使用する
  • ハイドレーション修正: useEffect の後にテーマトグルをマウントするか、suppressHydrationWarning を使用してハイドレーションの不一致を防ぐ
  • 永続化: next-themes は設定を localStorage に保存し、<html> に class として適用する
  • トランジション: スムーズなテーマ切り替えのために body に transition-colors duration-200 を追加する

パターン

// レイアウトラッパー
import { ThemeProvider } from "next-themes";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en" suppressHydrationWarning>
      <body>
        <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
          {children}
        </ThemeProvider>
      </body>
    </html>
  );
}
// テーマトグル
"use client";
import { useTheme } from "next-themes";
import { useEffect, useState } from "react";

export function ThemeToggle() {
  const { theme, setTheme } = useTheme();
  const [mounted, setMounted] = useState(false);
  useEffect(() => setMounted(true), []);
  if (!mounted) return null;

  return (
    <button onClick={() => setTheme(theme === "dark" ? "light" : "dark")}>
      {theme === "dark" ? "☀️" : "🌙"}
    </button>
  );
}
/* CSS変数 */
:root {
  --background: 0 0% 100%;
  --foreground: 222.2 84% 4.9%;
}
.dark {
  --background: 222.2 84% 4.9%;
  --foreground: 210 40% 98%;
}

避けるべきこと

  • CSS変数ではなく色をハードコーディングする — テーマ設定が不可能になる
  • <html> に suppressHydrationWarning を付け忘れる — ハイドレーションエラーの原因になる
  • テーマの誤表示: next-themes のスクリプトが描画前に実行されることを確認する(デフォルトで実施済み)
  • システムオプションなしでライト/ダークのみをサポートする — ユーザーのOS設定を尊重する

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

関連スキル