テーマ

Gunjo UI の CSS 変数を上書きしてシステムをカスタマイズする。

Gunjo UI はカラー・角丸・影・モーションのすべてを CSS 変数として公開しています。自分の :root または .dark ブロックで値を変えれば、全コンポーネントがそれを拾います ── Tailwind の再ビルドも fork も不要。

規約

変数は kebab-case、値は H S% L% の HSL トリプレット(hsl() ラッパーなし)。これにより Tailwind 側で透明度を合成できます(hsl(var(--primary) / 0.5))。

コンポーネントが実際に消費する セマンティックトークン は対で定義されています:

  • --background / --foreground ── ページ表面とメインテキスト
  • --card / --card-foreground ── Card 表面とテキスト
  • --popover / --popover-foreground ── 浮遊サーフェス(Tooltip / Popover / DropdownMenu)
  • --primary / --primary-foreground ── 群青ブルーと、その上に乗るテキスト
  • --secondary / --secondary-foreground ── 控えめなサーフェスとテキスト
  • --muted / --muted-foreground ── 背景とサブテキスト
  • --accent / --accent-foreground ── 媚茶ティントの hover / selection
  • --destructive / --destructive-foreground ── エラー / 危険操作
  • --border / --input / --ring ── 枠線とフォーカス
  • --radius ── 基本ボーダー半径

ブランド・アトモスフィアトークン

これらは テーマ非依存(dark mode で反転しない)── 群青と媚茶のブランドアイデンティティをモードを跨いで保つために、ホームヒーローと色のストーリー演出だけが消費します:

  • --gunjo-deep / -deeper / -deepest / -light / -mid / -bright / -dark ── 群青パレット
  • --kobicha-warm / -mid / -bright / -deepest ── 媚茶パレット
  • --pure-white, --pure-black

デフォルト(ライトモード)

:root {
  --background: 0 0% 100%;
  --foreground: 240 20% 6%;

  --card: 0 0% 100%;
  --card-foreground: 240 20% 6%;

  --popover: 0 0% 100%;
  --popover-foreground: 240 20% 6%;

  --primary: 232 39% 49%;            /* 群青 */
  --primary-foreground: 210 40% 98%;

  --secondary: 210 40% 96%;
  --secondary-foreground: 240 6% 10%;

  --muted: 210 40% 96%;
  --muted-foreground: 215 16% 47%;

  --accent: 29 31% 87%;              /* 媚茶ティント */
  --accent-foreground: 14 22% 19%;

  --destructive: 0 84% 60%;
  --destructive-foreground: 210 40% 98%;

  --border: 214 32% 91%;
  --input: 214 32% 91%;
  --ring: 232 39% 49%;

  --radius: 0.5rem;
}

ダークモード上書き

.dark {
  --background: 222.2 84% 4.9%;
  --foreground: 210 40% 98%;

  --card: 222.2 84% 4.9%;
  --card-foreground: 210 40% 98%;

  --popover: 222.2 84% 4.9%;
  --popover-foreground: 210 40% 98%;

  --primary: 232 47% 65%;            /* 暗い背景でコントラストを得るため少し明るめの群青 */
  --primary-foreground: 210 40% 98%;

  --secondary: 217.2 32.6% 17.5%;
  --secondary-foreground: 210 40% 98%;

  --muted: 217.2 32.6% 17.5%;
  --muted-foreground: 215 20.2% 65.1%;

  --accent: 14 22% 19%;
  --accent-foreground: 29 31% 87%;

  --destructive: 0 62.8% 30.6%;
  --destructive-foreground: 210 40% 98%;

  --border: 217.2 32.6% 17.5%;
  --input: 217.2 32.6% 17.5%;
  --ring: 232 47% 65%;
}

シャドウ・モーションを含む完全なリストは src/globals.css にあり、design/tokens.pen から自動生成されています。上書きは、採用先の globals.css@import "@gunjo/ui/styles" に変数を再宣言してください。