컴포넌트 갤러리 ⋅ 문서를 이루는 작은 규칙
Vibe Docs의 색, 글자, 여백, 형태와 상호작용을 한 페이지에서 확인한다.
이 문서의 목차
색은 역할이 있을 때
어두운 바탕과 두 단계의 표면 위에서 밝은 글자를 읽는다. 파스텔 면은 중요한 조건이나 관련 내용을 본문 가까이 묶을 때 사용한다.
색상은 Figma Dark 프리뷰다크 프리뷰의 색상 토큰getdesign.md의 독립 분석에서 확인한 어두운 바탕, 밝은 글자와 파스텔 표면을 사용한다. Figma가 배포한 공식 토큰은 아니다.를 기준으로 한다. 면의 밝기 차이와 얇은 경계로 본문과 패널을 구분한다.
#0a0a0a페이지의 바탕#161616카드의 바탕#1f1f1f선택된 면#ffffff제목과 핵심rgba(255,255,255,0.85)본문rgba(255,255,255,0.6)보조 정보#dceeb1핵심 요약#c5b0f4설명과 맥락#f4ecd6조건과 주의#c8e6cd완료와 확인#efd4d4관련 내용#f3c9b6변화와 과정#1f1d3d반전된 표면#2ecc5b완료한 단계글자의 크기로 읽는 순서 만들기
제목, 본문, 보조 정보는 크기와 명도만으로 구분한다. 본문은 충분한 줄높이를 유지하고, 작은 영문 레이블은 글자 사이를 벌려 본문과 다른 역할임을 드러낸다.
여백도 공통의 언어로
작은 요소 사이에는 4–16px, 카드 안에는 16px을 쓴다. 큰 섹션 사이에는 96px을 두어 내용의 전환을 알린다.
hair1pxxs4pxsm8pxmd12pxpanel16pxlg24pxsection96px형태로 연결하기
작은 면에는 낮은 곡률을, 큰 콘텐츠 패널에는 24px을 쓴다. 버튼과 탭은 양끝이 둥근 형태로 표시하고, 아이콘 버튼은 원으로 표시한다.
small·6PXmedium·8PXlarge·24PXpill·50PX행동의 우선순위 보여주기
링크의 출처 드러내기
외부 링크는 서비스 이름과 함께 표시한다. 독자는 주소를 열기 전에 어디로 이동하는지 알 수 있다.
2026-10-04에 확인한 공개 PR의 상태다. 각 링크에서 실제 제목과 작성자를 확인할 수 있다.
코드도 읽는 흐름에 맞게
파일 이름과 언어를 먼저 보여주고 문법을 구분한다. 여러 예시는 탭으로 묶되, 각 탭만 읽어도 목적을 이해할 수 있게 작성한다.
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
예정 발행
검증을 통과한 현재 상태를 배포 대상으로 삼는다.