doksam-ui
홈ProfilesTokensIconsComponentsPatternsRules

Tokens

프리셋별 컬러 토큰, radius, 간격, 타이포그래피 스케일입니다. 하드코딩 색 대신 항상 이 시맨틱 토큰을 사용하세요.

컬러 토큰

현재 프리셋의 시맨틱 토큰입니다. 우상단 스위처로 프리셋·라이트/다크를 바꾸면 CSS 변수가 갱신되어 아래 스와치도 자동으로 반영됩니다.

--background

페이지 최상위 배경

--foreground

기본 본문 텍스트

--card

카드·패널 배경

Ag
--card-foreground

카드 위 텍스트

--popover

팝오버·드롭다운·툴팁 배경

Ag
--popover-foreground

팝오버 위 텍스트

--primary

주요 액션(버튼·강조 요소) 배경

Ag
--primary-foreground

primary 위 텍스트

--secondary

보조 액션 배경

Ag
--secondary-foreground

secondary 위 텍스트

--muted

톤 다운된 배경(구분 영역)

Ag
--muted-foreground

설명·보조 텍스트

--accent

hover/선택 상태 강조 배경

Ag
--accent-foreground

accent 위 텍스트

--destructive

삭제·위험 액션

--success

성공·완료 상태

--warning

경고 상태

--gain

한국식 등락 — 이익/상승(빨강)

--loss

한국식 등락 — 손실/하락(파랑)

--border

테두리 선

--input

입력 필드 테두리

--ring

포커스 링

--chart-1

차트 시리즈 1

--chart-2

차트 시리즈 2

--chart-3

차트 시리즈 3

--chart-4

차트 시리즈 4

--chart-5

차트 시리즈 5

금융 토큰

한국식 시세 등락 색(--gain=이익/상승, --loss=손실/하락)입니다. 다른 시맨틱 색과 동일하게 모든 프리셋에서 같은 값을 쓰며(브랜드가 아닌 도메인 관례), lib/finance/rate.ts의 rateColor/rateText, lib/finance/format-won.ts의 formatWon과 함께 씁니다. 자세한 데모는 /components/rate-color· /components/format-won를 참고하세요.

--gain

한국식 등락 — 이익/상승(빨강)

--loss

한국식 등락 — 손실/하락(파랑)

rateColor / rateText

+1.23%-0.87%0.00%

formatWon

5억1.0조-12,340,000원

Radius

기본 radius는 6px(절제된 곡선)이고, 나머지 스텝은 여기에 비례합니다.

radius-sm
3.6px
radius-md
4.8px
radius-lg (기본)
6.0px
radius-xl
8.4px
radius-2xl
10.8px
radius-3xl
13.2px
radius-4xl
15.6px

간격

Tailwind 기본 4px 그리드 중 권장 스텝입니다. 클래스는 p-{n}, gap-{n} 등으로 그대로 사용합니다.

1
4px
2
8px
3
12px
4
16px
6
24px
8
32px
12
48px
16
64px

타이포그래피

페이지 제목 · 섹션 · 본문 · 보조 · 코드 5단 스케일입니다. 사이드바 상단 스위처로 폰트 프리셋을 바꾸면 사이트 전체 본문 서체가 즉시 반영됩니다. 모든 폰트는 next/font/local로 레포에 self-host되어 있어 폐쇄망 환경에서도 외부 CDN 요청 없이 동작합니다.

페이지 제목text-3xl font-semibold tracking-tight

doksam-ui

섹션 제목text-lg font-medium

컬러 토큰

본문text-sm

시맨틱 토큰만 사용하고 하드코딩 색은 금지합니다.

보조text-xs text-muted-foreground

프리셋 전환 시 자동으로 반영됩니다.

코드rounded-sm bg-muted px-1.5 py-0.5 font-mono text-sm

var(--primary)

Geist · Noto Sans KR · IBM Plex Sans KR · Nanum Gothic · Space Grotesk — 모두 SIL Open Font License(OFL) 무료 폰트이며, assets/fonts/ 에 self-host(woff2 내장)되어 폐쇄망에서도 외부 CDN 요청 없이 동작합니다. Space Grotesk 는 라틴 전용 폰트로 한글은 시스템 폰트로 폴백되며, mono 요소는 페어링 폰트인 Space Mono 로 함께 전환됩니다(다른 프리셋은 Geist Mono 유지).

복사해 쓰는 법

소비 프로젝트의 globals.css에 붙여넣을 프리셋별 CSS 변수 블록입니다.

Ocean
Forest
Violet
Ember
Rose
Slate
Gold