Communitygithub.com

YepAPI/skills

Commutation de thème avec variables CSS, détection des préférences système, next-themes et persistance.

Qu'est-ce que skills ?

Cette compétence permet de gérer facilement le mode sombre dans une application Next.js en utilisant la bibliothèque `next-themes`. Elle définit les règles pour configurer un fournisseur de thème, des variables CSS pour les couleurs claires et sombres, et la détection automatique de la préférence système via `prefers-color-scheme`. Le composant de bascule de thème utilise le hook `useTheme()` pour alterner entre les modes clair, sombre et système, avec une correction d'hydratation pour éviter les erreurs. La persistance du choix de l'utilisateur est assurée par `localStorage`, et les transitions CSS sont appliquées pour une expérience fluide. Elle s'intègre parfaitement avec Tailwind CSS en activant le mode `darkMode: 'class'`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Mode Sombre

Règles

  • Utilisez next-themes pour les applications Next.js — enveloppez l'application dans <ThemeProvider attribute="class" defaultTheme="system">
  • Variables CSS pour les couleurs — définissez dans :root (clair) et .dark (sombre), référencez comme var(--background)
  • Détection des préférences système : defaultTheme="system" respecte la media query prefers-color-scheme
  • Composant de bascule de thème : cycle entre clair/sombre/système — utilisez le hook useTheme() de next-themes
  • Intégration Tailwind : activez darkMode: "class" dans la configuration tailwind, utilisez le préfixe dark: pour les surcharges
  • Correction d'hydratation : supprimez les erreurs d'hydratation en montant le bouton de thème uniquement après useEffect ou en utilisant suppressHydrationWarning
  • Persistance : next-themes stocke la préférence dans localStorage et l'applique comme une classe sur <html>
  • Transition : ajoutez transition-colors duration-200 au body pour un changement de thème fluide

Modèles

// Wrapper de mise en page
import { ThemeProvider } from "next-themes";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="fr" suppressHydrationWarning>
      <body>
        <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
          {children}
        </ThemeProvider>
      </body>
    </html>
  );
}
// Bascule de thème
"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>
  );
}
/* Variables CSS */
:root {
  --background: 0 0% 100%;
  --foreground: 222.2 84% 4.9%;
}
.dark {
  --background: 222.2 84% 4.9%;
  --foreground: 210 40% 98%;
}

À éviter

  • Coder en dur des couleurs au lieu de variables CSS — rend le theming impossible
  • Oublier suppressHydrationWarning sur <html> — provoque des erreurs d'hydratation
  • Flash du mauvais thème : assurez-vous que le script next-themes s'exécute avant le rendu (c'est le cas par défaut)
  • Ne supporter que clair/sombre sans option système — respectez la préférence OS de l'utilisateur

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.

Skills associés