Design System Reference

creation-space Design System

人間: ブラウザで見て「このカードのこの色や余白を変えたい」を指差すためのページです。AI: HTML ソース内のコメント、data-componentdata-variables、下の変数テーブルを読んで、CSS 変数とコンポーネントの対応を把握するためのページです。

正本は 3 層です。トークン値は src/styles/shell.css、コンポーネントの見本と意図はこのページ、変更ルールは docs/design-system.md を見ます。

22 カラーパレット --color-* / --kesson-md-* / --kesson-error-*
51 タイポグラフィ --kesson-font-* / --kesson-letter-* / --kesson-topbar-*
14 スペーシング・レイアウト --kesson-radius-* / --kesson-transition-* / --kesson-topbar-*
22 コンポーネント表層 --kesson-card-* / --kesson-offcanvas-* / --kesson-viewer-*
6 + 1 UI部品 + Reports橋渡し --kesson-ui-* / --kesson-focus-* / --reports-font-step

Token Map

現在の shell.css :root は 116 個の root token と、Reports の文字調整用ブリッジ --reports-font-step を持ちます。加えて reports.css には 40 個の component-local 変数、viewer.cssdev-legacy.css には --bs-offcanvas-width の橋渡し変数があります。

Source files: src/styles/shell.css, src/styles/topbar.css, src/styles/dev-panel.css, src/styles/viewer.css, src/styles/reports.css, src/styles/articles.css, src/styles/creation.css, src/styles/dev-legacy.css

分類ルール

AI は prefix を起点に読むと速いです。色は --color-*、文字は --kesson-font-*--kesson-topbar-*、表層は --kesson-card-*--reports-* が担当します。

--color-* --kesson-font-* --kesson-card-* --kesson-offcanvas-* --kesson-viewer-* --kesson-ui-* --reports-*

読み順

変更前は docs/design-system.md を読んだ上で、このページの対象コンポーネントまで飛び、下の変数テーブルから root token と local var を辿ります。

Color Palette

ベース 6 色と Markdown / error 系の派生色をまとめて確認します。色相の変更はここを見てから、カード、リンク、MD 表示、エラー表示まで影響範囲を辿ります。

Core Palette

サイト全体の基本色です。特に --color-accent--color-sub-text はカード、ボタン、topbar、reports の土台になります。

Accent --color-accent
Sub Text --color-sub-text
Highlight --color-highlight
Link --color-link
Heading --color-heading
Body Background --color-bg-body

Markdown + Error Colors

Markdown 本文と異常表示の色です。現状の CSS では viewer 側に同値の直書きも残っているため、ここは将来的な集約候補です。

MD H1 --kesson-md-h1
MD H2 --kesson-md-h2
MD Link --kesson-md-link
MD Quote --kesson-md-quote
Inline Code BG --kesson-md-inline-code-bg
Error --kesson-error-color

Typography Scale

display serif、UI serif、mono と、UI 用サイズ・letter spacing をまとめて見ます。topbar 系の文字トークンもここに含まれます。

Font Families and Steps

display は見出し、UI serif は注釈・ボタン、mono は制御とメタ情報に使われています。

Display Serif 創造とは / Design intent / Section heading --kesson-font-serif-display
UI Serif Actions, notes, reports explanation --kesson-font-serif-ui
Mono UI DEV / LABEL / A+ / D23 / 0x001 --kesson-font-mono-ui
scroll / ui-xs
support text / ui-sm
▾ ▴ ↺
--kesson-font-size-ui-xs, --kesson-font-size-ui-sm, --kesson-font-size-ui-arrow

Runtime Chrome

topbar、スクロールヒント、ナビゲーションラベル、開発トグルなど、ページ全体を包む UI 部品です。固定配置のものはここでは静的レイアウトに落として見せています。

Topbar

index.html の topbar を縮小して再現しています。ナビゲーションの見え方とコラボ注記の強さをここで確認します。

Hints, Labels, Toggle

scroll hint、left link、control guide、開発トグルの色と存在感をまとめて見ます。

kesson
build: develop / sample-token-view
DEV PANEL

Buttons and Actions

ボタンと操作チップです。共通 action token と articles / reports の派生 UI を並べて、硬さやコントラストを揃えます。

Action Surface

--kesson-action-* は canonical token として定義されています。Bootstrap .btn を土台にし、色とコントラストだけを token で上書きします。

Cards and Surfaces

カード群、placeholder、metric panel をまとめています。カードの浮遊感は --kesson-card-bg と shadow token の組み合わせで決まります。

Card Family

articles / reports 共通の土台です。border を上げると輪郭が立ち、shadow を上げると浮遊感が増します。

Sample Card

創造モデルの概要カード。記事、reports feature、creation card がこの系列に乗ります。

Coverage
24 / 30 domains

Future Card

articles.css 側の placeholder。実データがない領域でもトーンを崩さず仮置きできるようにしています。

Offcanvas and Viewer

横パネルとモーダル viewer のガラス面です。背景が暗いので、blur と border は少しの差でも印象が大きく変わります。

Offcanvas Panel

offcanvas-kesson は width と background を token で制御しています。本文文字色とリンク色は今後 token 利用を増やせる余地があります。

Viewer Glass

Markdown や外部埋め込みの viewer 面です。スクロールバーも含めて確認できます。

source: docs/design-system.md / component viewer

Viewer Surface

ここでは overlay と glass border の見え方を確認します。中の本文要素は次のセクションで詳しく見ます。

MD Viewer Elements

見出し、リンク、引用、コード、テーブルをまとめて表示します。AI はこのブロックを見ると、Markdown 系 token の実際の着地点を把握できます。

Markdown Body

viewer.css 側は一部が値直書きなので、ここで見た値と shell token を照合しながら調整する前提です。

docs / provenance / 2026-03-15

Design System Overview

この本文は カードreports と同じ root palette を共有します。inline code は var(--kesson-md-inline-code) を想定しています。

Hierarchy

Subsection

Minor heading

ダークテーマ上では引用を少し抑え、リンクだけをはっきり光らせる。
const target = document.querySelector('[data-component=\"kesson-card\"]');
Role Variable
Link --kesson-md-link
Quote --kesson-md-quote

Forms and Dev Panel

フォーム要素は主に dev panel と reports 周辺で使われます。focus ring と入力面の暗さをここで確認します。

Dev Panel Form Controls

dev-panel.css の input / label / range を縮小展示しています。トグルは runtime chrome と同じ token を共有します。

Error State

articles の読み込み失敗表示に相当します。

記事データを読み込めませんでした。ネットワークと JSON を確認してください。

Reports UI

reports.css の local var で組まれている領域です。root token を束ねた派生層なので、reports だけを変えるのか root から変えるのかをここで判断します。

Reports Overview, Chip, Domain Item

palette は Dxx カードのバリエーション、panel 系は overview と metric card の土台、font step は文字拡大縮小のブリッジです。

AI collaborative reports. Local vars here are derived from root palette and spacing tokens.

L3 synthesis

Progress
80%
D23 deepdive

発達心理学

D07 surveyed

認知科学

Font Size Control (A+/A-)

src/font-size-ctrl.js が管理するフォントサイズ調整機能のデモです。A+ / A- ボタンで全 CSS 変数が連動します。step は localStorage に保存され、ページ間で共有されます。

Controls

ボタンを押すとページ全体のフォントサイズが変わります。step 範囲: -1 ~ 7 (default: 0)

step: 0

Sample Text at Various Variables

section-heading: SAMPLE HEADING

card-title: Sample Card Title

card-text: Sample card description text

overlay-tagline: Sample tagline

footer-line: <footer sample text />

topbar-main-title: creation-space

h1-size: Hero Heading