문서 목록
DESIGN SYSTEM

컴포넌트 갤러리 ⋅ 문서를 이루는 작은 규칙

Vibe Docs의 색, 글자, 여백, 형태와 상호작용을 한 페이지에서 확인한다.

·8 min read
이 문서의 목차

색은 역할이 있을 때

어두운 바탕과 두 단계의 표면 위에서 밝은 글자를 읽는다. 파스텔 면은 중요한 조건이나 관련 내용을 본문 가까이 묶을 때 사용한다.

색상은 Figma Dark 프리뷰다크 프리뷰의 색상 토큰getdesign.md의 독립 분석에서 확인한 어두운 바탕, 밝은 글자와 파스텔 표면을 사용한다. Figma가 배포한 공식 토큰은 아니다.를 기준으로 한다. 면의 밝기 차이와 얇은 경계로 본문과 패널을 구분한다.

CANVAS#0a0a0a페이지의 바탕
SURFACE#161616카드의 바탕
ELEVATED#1f1f1f선택된 면
INK#ffffff제목과 핵심
BODYrgba(255,255,255,0.85)본문
SECONDARYrgba(255,255,255,0.6)보조 정보
LIME#dceeb1핵심 요약
LILAC#c5b0f4설명과 맥락
CREAM#f4ecd6조건과 주의
MINT#c8e6cd완료와 확인
PINK#efd4d4관련 내용
CORAL#f3c9b6변화와 과정
NAVY#1f1d3d반전된 표면
SUCCESS#2ecc5b완료한 단계

글자의 크기로 읽는 순서 만들기

제목, 본문, 보조 정보는 크기와 명도만으로 구분한다. 본문은 충분한 줄높이를 유지하고, 작은 영문 레이블은 글자 사이를 벌려 본문과 다른 역할임을 드러낸다.

DISPLAY큰 시작점64 / 1.1
HEADING XL섹션의 제목24 / 1.6
HEADING MD카드의 제목20 / 1.4
BODY LG도입과 핵심 설명18 / 1.6
BODY MD본문을 읽는 기본 속도16 / 1.6
BODY SM보조 설명과 캡션14 / 1.6
EYEBROWRESEARCH & DECISIONS / 202612 / 1.5

여백도 공통의 언어로

작은 요소 사이에는 4–16px, 카드 안에는 16px을 쓴다. 큰 섹션 사이에는 96px을 두어 내용의 전환을 알린다.

내용이 길어져도 높이를 늘린다. 글자 크기를 줄이거나 다른 요소를 가려서 맞추지 않는다.
hair1px
xs4px
sm8px
md12px
panel16px
lg24px
section96px

형태로 연결하기

작은 면에는 낮은 곡률을, 큰 콘텐츠 패널에는 24px을 쓴다. 버튼과 탭은 양끝이 둥근 형태로 표시하고, 아이콘 버튼은 원으로 표시한다.

small·6PX
medium·8PX
large·24PX
pill·50PX

행동의 우선순위 보여주기

한 화면에서 가장 중요한 행동 하나만 흰색으로 채운다. 보조 행동은 어두운 면과 경계선으로 표현하고 아직 쓸 수 없는 행동은 명도를 낮춘다.

코드도 읽는 흐름에 맞게

파일 이름과 언어를 먼저 보여주고 문법을 구분한다. 여러 예시는 탭으로 묶되, 각 탭만 읽어도 목적을 이해할 수 있게 작성한다.

project-milestones.tsxTSX
import { Timeline } from "@/components/timeline";export const ProjectMilestones = () => (  <Timeline    initialStep={2}    interactive    items={[      { id: "prepare", title: "준비", content: "질문을 정한다." },      { id: "compose", title: "구성", content: "근거를 배치한다." },      { id: "verify", title: "검증", content: "화면을 확인한다." },    ]}  />);

코드와 인라인 식별자는 D2Coding으로 표시한다. TypeScript 예시에는 강조, 추가, 삭제, 경고, 오류의 줄 표시를 함께 담았다. 본문 속initialStep은 같은 글꼴을 사용한다.

시간에 따른 변경과 마일스톤

현재 단계의 앞뒤 맥락이 중요할 때 타임라인을 쓴다. 이전 단계와 다음 단계 버튼으로 상태를 바꾸며 완료, 진행 중, 예정의 차이를 확인할 수 있다.

3 / 4 · 검증
  1. 완료

    준비

    독자와 문서가 답할 질문을 정한다.

  2. 완료

    구성

    핵심 주장과 근거를 읽는 순서대로 놓는다.

  3. 3
    진행 중

    검증

    문장, 링크, 코드와 작은 화면의 렌더 결과를 확인한다.

  4. 4
    예정

    발행

    검증을 통과한 현재 상태를 배포 대상으로 삼는다.