Devendency

person

Design System

Devendency

KRDS(한국형 디자인 시스템)의 3계층 토큰 구조를 참고하여 구성된 디자인 가이드입니다. 사이트에서 사용하는 모든 컴포넌트가 여기에 매핑되어 있습니다.

Primitive원시 값
Semantic의미 기반
Component컴포넌트별
01Primitive Token

Color Palette

KRDS의 13단계 명도 체계를 참고한 색상 팔레트입니다. 50을 기준색으로, 접근성 대비율(WCAG AA)을 준수합니다.

Primary

5#f0edfe
10#e0d9fd
20#c2b4fb
30#a48ef9
40#8f7bf5
50#7f6df2
60#6c5ce7
70#5a4bd4
80#483bbf
90#362ba8
95#2a2080
5
10
20
30
40
50
60
70
80
90
95

Gray

0#ffffff
5#f5f5f5
10#e8e8e8
20#d1d1d1
30#b0b0b0
40#949494
50#787878
60#555555
70#3d3d3d
80#262626
90#1a1a1a
95#111111
100#000000
0
5
10
20
30
40
50
60
70
80
90
95
100

System

Success

#22c55e

Warning

#f59e0b

Danger

#ef4444

Info

#3b82f6

02Theme Variables

Semantic Tokens

Primitive 토큰을 참조하는 의미 기반 토큰입니다. 라이트/다크 모드에 따라 값이 전환됩니다.

TokenLightDark
--background
--foreground
--card
--primary
--border
--ring
--active-line
03Type Scale

Typography

KRDS의 Display-Heading-Body 계층을 참고한 타이포그래피 시스템입니다. Pretendard 서체를 기본으로, 코드에는 Fira Code를 사용합니다.

다람쥐 헌 쳇바퀴에 타고파

Display

2.5rem · 800 · 1.2

페이지 대제목

다람쥐 헌 쳇바퀴에 타고파

Heading L

2rem · 700 · 1.3

섹션 제목

다람쥐 헌 쳇바퀴에 타고파

Heading M

1.5rem · 700 · 1.35

서브섹션 제목

다람쥐 헌 쳇바퀴에 타고파

Heading S

1.25rem · 600 · 1.4

소제목

다람쥐 헌 쳇바퀴에 타고파

Body L

1.0625rem · 400 · 1.75

본문 (17px)

다람쥐 헌 쳇바퀴에 타고파

Body M

1rem · 400 · 1.75

기본 본문

다람쥐 헌 쳇바퀴에 타고파

Body S

0.875rem · 400 · 1.5

보조 텍스트

다람쥐 헌 쳇바퀴에 타고파

Caption

0.75rem · 400 · 1.5

캡션/라벨

const hello = 'world';

Code

0.85rem · 400 · 1.65

코드 블록

Sans (본문)

Pretendard

가나다라마바사 아자차카타파하
ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz 0123456789

Mono (코드)

Fira Code

=> !== === :: ... #[] <> 0x1F
function() { return true; }
ABCDEFG abcdefg 0123456789

044px Base Unit

Spacing

4px 기반의 간격 시스템입니다. 일관된 여백과 패딩을 위해 토큰화된 간격 스케일을 사용합니다.

space-14px
space-28px
space-312px
space-416px
space-520px
space-624px
space-832px
space-1040px
space-1248px
space-1664px
05Shape Tokens

Border Radius

KRDS의 Small-Medium-Large-XLarge 4단계 체계를 참고한 모서리 둥글기 스케일입니다.

Small

radius-sm

4px

Medium

radius-md

8px

Large

radius-lg

12px

XLarge

radius-xl

16px

Full

radius-full

9999px

06Elevation

Shadows & Effects

깊이와 계층을 표현하는 그림자 및 효과 토큰입니다.

shadow-sm

버튼, 아바타

shadow-lg

드롭다운, 카드

shadow-2xl

모달, 라이트박스

backdrop-blur

헤더, 오버레이

07Material Symbols

Icons

Google Material Symbols Outlined 아이콘을 사용합니다. fontVariationSettings로 크기와 굵기를 제어합니다.

light_mode

light_mode

dark_mode

dark_mode

routine

routine

search

search

edit

edit

delete

delete

favorite

favorite

visibility

visibility

share

share

link

link

arrow_back

arrow_back

arrow_forward

arrow_forward

expand_more

expand_more

expand_less

expand_less

check

check

close

close

add

add

remove

remove

person

person

settings

settings

logout

logout

photo_camera

photo_camera

content_copy

content_copy

lock

lock

menu

menu

08Component Token

Buttons

사이트 전체에서 사용하는 버튼 변형입니다. Header, Post, Auth, Admin 등에서 사용됩니다.

기본 버튼

상태 버튼

Pill / Round 버튼 (Header, Follow)

아이콘 버튼

09Input · Select · Checkbox · Radio · Toggle

Form Controls

Auth, Settings, Admin, Editor 등에서 사용하는 폼 컨트롤입니다.

Text Input

@

도움말 텍스트가 여기에 표시됩니다.

Textarea

Select

Checkbox · Radio · Toggle

Checkbox

Radio

Toggle Switch

활성
비활성
10ThemeToggle.tsx

Theme Toggle

3-way 토글 (Light / Auto / Dark). Material Symbols Outlined 아이콘을 사용합니다.

현재 사이트 스타일 (Header)

light_mode
routine
dark_mode
11Profile · Comment · Post

Avatar

사용자 프로필 이미지 또는 이니셜 뱃지입니다. 다양한 크기로 사용됩니다.

A

size-5

20px (post meta)

B

size-8

32px (comment)

C

size-9

36px (header menu)

D

size-20

80px (settings)

U
photo_camera

upload

settings hover

12Status · Role · Tag

Badges & Tags

포스트 태그, 역할 뱃지, 상태 인디케이터 등에 사용됩니다.

컬러 뱃지

PrimarySuccessWarningDangerInfoNeutral

Admin 역할 뱃지

ADMINWRITERUSER

상태 인디케이터

공개
비공개
정지
미인증

포스트 태그

ReactTypeScriptNext.jsTailwind
13Post · Settings · Info

Cards

포스트 카드, 설정 카드, 정보 카드 등 콘텐츠 그룹화에 사용됩니다.

Post Card

Next.js 16에서 달라진 것들

App Router의 새로운 기능과 변경 사항을 정리했습니다.

A
Author·2일 전·favorite42

Settings Card

프로필 설정

Alert / Notice

이메일 인증이 필요합니다.
삭제된 항목은 복구할 수 없습니다.

Series Nav Card

React 시리즈expand_more
1. React 기초
2. Hooks 패턴 (현재)
3. 상태 관리
14Tab · Sidebar · Pagination · TOC

Navigation

탭 네비게이션, 사이드바, 페이지네이션, 목차 등 탐색 관련 컴포넌트입니다.

Feed Tabs

Admin Tabs (Underline)

Sidebar Nav

dashboard대시보드
edit새 글 쓰기
collections_bookmark시리즈
settings설정

Pagination

Table of Contents (TOC)

목차

소개
설치 방법
npm으로 설치
yarn으로 설치
사용법

Scroll Progress

포스트 읽기 진행률 (상단 고정)

15Dialog · Confirm · Search · Lightbox

Modals & Overlays

확인 대화상자, 검색 모달, 이미지 라이트박스 등의 오버레이 컴포넌트입니다.

Confirm Modal

삭제 확인

이 작업은 되돌릴 수 없습니다.

확인을 위해 아래 텍스트를 입력하세요

삭제합니다

Search Modal

search검색어를 입력하세요...ESC
검색 결과가 여기에 표시됩니다

Dropdown Menu

person내 프로필
settings설정
logout로그아웃

Context Menu (YouTube)

https://youtu.be/abc123
smart_display임베드로 삽입
link링크로 삽입
16Comment Form · Thread

Comments

댓글 작성 폼과 스레드형 댓글 목록입니다.

Comment Thread

K
Kim3시간 전

좋은 글이네요! 많은 도움이 되었습니다.

L
Lee1시간 전

저도 동의합니다!

17Admin Data Table

Table

관리자 패널의 데이터 테이블 스타일입니다.

Admin Table

제목상태액션
React Hooks 완벽 가이드공개
TypeScript 제네릭 이해하기비공개
18Loading · Empty · Error · Skeleton

States

로딩, 빈 상태, 에러, 스켈레톤 등 상태별 UI입니다.

Loading Spinner

Skeleton

Empty State

article

아직 작성된 글이 없습니다

Scroll to Top

스크롤 상단 이동 (fixed bottom-right)
19Syntax Highlight

Code Block

highlight.js 기반의 코드 블록입니다. 라이트/다크 테마를 각각 제공합니다.

코드 블록 (다크)

example.tsx
const greeting = "Hello, World!";
20Obsidian Markdown

Content Styles

블로그 콘텐츠에 적용되는 Obsidian 스타일 마크다운 렌더링입니다.

Inline Code

변수를 선언할 때는 const 키워드를 사용합니다.

Blockquote

좋은 코드는 그 자체로 최고의 문서이다.

Link

Obsidian 스타일의 보라색 링크

Emphasis

Bold 텍스트, Italic 텍스트, Strikethrough

Task List

Table

이름설명
Props컴포넌트 속성
State내부 상태
21Responsive Breakpoints

Layout & Grid

반응형 레이아웃 시스템입니다. max-width: 1200px 컨테이너와 Tailwind 브레이크포인트를 사용합니다.

sm640pxGrid: 1col모바일
md768pxGrid: 2col태블릿
lg1024pxGrid: 3col데스크탑
xl1280pxGrid: 4col와이드

KRDS(한국형 디자인 시스템) v1.0.0의 토큰 구조를 참고하여 Devendency에 맞게 재구성하였습니다.
자세한 내용은 krds.go.kr에서 확인할 수 있습니다.