이 글의 내용
김희준
김희준

2026년 11월 15일 업데이트

UI 스타일 가이드는 반복해서 내리는 시각적 결정을 명확히 기록합니다. 어떤 텍스트 스타일을 쓸지, 색이 무엇을 뜻하는지, 요소 사이에 얼마만큼의 공간을 둘지, 컴포넌트가 어떻게 동작할지를 정하는 문서입니다. 화면마다 담당자의 해석에 맡기지 않고 디자이너와 개발자가 함께 참고할 기준을 제공합니다.

일관성은 출발점이지 접근성이나 사용성이 확보되었다는 증거는 아닙니다. 대비, 읽기 쉬운 텍스트, 키보드 초점, 컴포넌트 상태에 관한 규칙도 필요하며, 팀은 실제 구현된 제품에서 이를 확인해야 합니다.

팀이 가장 자주 반복하는 결정부터 정리하세요. 언제 써야 하는지 설명이 없는 방대한 색상 견본보다 실제 화면에 근거한 작은 가이드가 더 유용합니다. 규칙을 Pixso 디자인 시스템의 재사용 가능한 에셋과 연결하면 문서의 지침과 컴포넌트를 함께 검토할 수 있습니다.

타이포그래피·색상·레이아웃·컴포넌트로 구성한 UI 스타일 가이드와 배경의 차트·캘린더 예시.

타이포그래피·색상·레이아웃·컴포넌트로 구성한 UI 스타일 가이드와 배경의 차트·캘린더 예시.이미지를 열어 확대

1. UI 스타일 가이드란?

스타일 가이드는 디자인을 결정할 때 도움이 되어야 합니다. 타이포그래피, 색상, 간격, 레이아웃, 컴포넌트, 인터페이스 문구를 다루고 적절한 사용 예시를 넣으세요. 새 팀원이 완성된 스크린샷만 보고 추측하지 않아도 필요한 패턴을 찾고 그 적용 범위를 이해할 수 있어야 합니다.

2. UI 스타일 가이드에 필요한 항목

모든 제품에 맞는 하나의 스타일 가이드는 없습니다. 제품과 팀의 필요에 따라 범위를 정해야 합니다. 템플릿은 기존 색상, 텍스트 스타일, 컴포넌트를 정리하는 데 도움이 되지만 사용 방법, 접근성, 예외를 자동으로 설명해 주지는 않습니다. 다음 항목을 실무의 출발점으로 삼으세요.

1. 타이포그래피

글꼴, 크기, 굵기, 줄 높이와 함께 페이지 제목, 본문, 입력 필드 레이블, 보조 텍스트 등 용도를 기록합니다. 짧은 샘플뿐 아니라 긴 레이블과 실제에 가까운 문단도 보여 주세요. 대체 글꼴을 지정하고 지원 언어에 필요한 글자가 모두 표시되는지 확인합니다.

제목, 본문, 보조 문구, 버튼의 텍스트 역할을 구분한 견본. Lorem ipsum은 글꼴 비교를 위한 임시 문구입니다.

제목, 본문, 보조 문구, 버튼의 텍스트 역할을 구분한 견본. Lorem ipsum은 글꼴 비교를 위한 임시 문구입니다.이미지를 열어 확대

2. 색상 팔레트

색상은 16진수 값만이 아니라 용도로 정의하세요. 주요 작업, 일반 텍스트, 테두리, 오류, 선택 상태를 구분합니다. 전경색과 배경색의 조합 및 필요한 대비 기준도 보여 주세요. 큰 제목에 적합한 색이 작은 보조 텍스트에도 적합한 것은 아닙니다.

브랜드 색상, 음영, 상태 색상, 그라데이션, 텍스트·배경·회색 견본. 실제 전경색과 배경색의 조합으로 대비를 확인해야 합니다.

브랜드 색상, 음영, 상태 색상, 그라데이션, 텍스트·배경·회색 견본. 실제 전경색과 배경색의 조합으로 대비를 확인해야 합니다.이미지를 열어 확대

3. 레이아웃

간격 값, 정렬 규칙, 콘텐츠 너비, 사용 가능한 공간이 달라질 때의 배치 방식을 기록합니다. 같은 화면에 좁은 뷰포트와 긴 콘텐츠를 적용한 예시를 보여 주세요. 이렇게 해야 고정 너비의 구성을 그대로 복사하는 대신 어떤 규칙을 유연하게 바꿔야 하는지 알 수 있습니다.

간격과 배치를 보여 주는 레이아웃 예시. 배경 수치와 문구는 디자인 견본이며 조사 결과를 뜻하지 않습니다.

간격과 배치를 보여 주는 레이아웃 예시. 배경 수치와 문구는 디자인 견본이며 조사 결과를 뜻하지 않습니다.이미지를 열어 확대

4. 컴포넌트

기본, 필요한 경우의 마우스 오버, 초점, 선택, 비활성, 로딩, 오류 등 사용자가 실제로 접하는 상태를 보여 주세요. 외형과 함께 레이블과 동작도 설명합니다. 예를 들어 비활성 버튼과 로딩 버튼은 모두 추가 제출을 막을 수 있지만, 각각 다른 이유를 전달합니다.

Iconsax 아이콘을 16·24·32 크기와 선형·굵게·윤곽 스타일로 비교한 견본. 상호작용 상태는 따로 정의해야 합니다.

Iconsax 아이콘을 16·24·32 크기와 선형·굵게·윤곽 스타일로 비교한 견본. 상호작용 상태는 따로 정의해야 합니다.이미지를 열어 확대

위 아이콘 시트는 하나의 에셋 모음 안에서 크기와 시각적 변형을 일관되게 구성한 예시입니다. 완성도 있는 컴포넌트 가이드에는 아래 초대 폼처럼 상호작용과 처리 결과를 전달하는 상태도 필요합니다.

3. UI 스타일 가이드 만드는 방법

대표 화면 몇 개를 점검하는 것부터 시작하세요. 반복되는 텍스트 스타일, 색상, 간격, 컴포넌트를 모은 뒤 의도치 않은 차이를 찾습니다. 각 항목에 일관된 규칙을 선택하고 제품에 적합한 이유를 기록합니다. 템플릿은 결정을 담는 틀로 사용해야 하며, 가이드가 완성되었다는 증거로 삼아서는 안 됩니다.

제품 전체에 적용하기 전에 실제에 가까운 프로토타입에서 규칙을 시험하세요. 단독으로는 명확한 버튼 스타일도 번역된 긴 레이블이나 옆의 오류 메시지와 함께 놓으면 문제가 생길 수 있습니다. 디자이너와 개발자가 함께 검토하고, 합의한 예외를 기록하며, 이후 변경을 관리할 담당자를 정합니다.

팀원 초대를 위한 작은 스타일 가이드

이메일 필드, 역할 선택기, ‘초대 보내기’ 버튼이 있는 폼을 생각해 보세요. 디자인 팀에 서로 비슷하지만 레이블, 간격, 오류 스타일이 조금씩 다른 화면이 세 개 있습니다. 유용한 가이드는 공통 패턴의 의미를 정한 다음, 실제로 사용하는 화면에서 그 규칙을 보여 줍니다.

규칙결정 예시확인할 화면
텍스트 역할폼 제목, 항상 표시되는 필드 레이블, 입력값, 보조 메시지에 각각 이름을 붙인 스타일을 사용합니다.짧은 기본 문구와 함께 긴 워크스페이스 이름 및 두 줄짜리 역할 설명을 보여 줍니다.
색상 역할작업, 일반 텍스트, 필드 경계, 오류에 용도별 색상 이름을 붙이고 전경색과 배경색을 한 쌍으로 지정합니다.빨간색 견본만 따로 놓지 말고 폼 배경 위에 실제 오류 메시지를 표시합니다.
간격레이블과 해당 컨트롤을 가깝게 배치합니다. 컨트롤과 도움말 사이보다 서로 다른 필드 사이에 더 큰 간격을 둡니다.일반 폼과 긴 유효성 검사 메시지가 있는 폼을 비교합니다.
버튼 동작제출 중에는 ‘초대 보내기’를 ‘보내는 중…’으로 바꾸고 성공하면 초대한 주소를 명시합니다.동일한 폼 내용으로 준비, 제출 중, 성공 확인, 실패 상태를 보여 줍니다.
콘텐츠 증가도움말과 오류 문구가 줄바꿈되고 폼의 높이가 늘어날 수 있게 합니다.좁은 프레임과 긴 번역 레이블을 사용하되, 공간에 맞추려고 모든 글자를 줄이지 않습니다.

간격 예시로 레이블과 컨트롤 사이는 8px, 필드 그룹 사이는 24px부터 시험할 수 있습니다. 이는 이 폼을 위한 후보값이지 접근성 요구사항이나 모든 곳에 적용되는 척도가 아닙니다. 실제 콘텐츠에 적용한 뒤 의도한 묶음이 잘 드러나는지 판단하세요. 화면마다 이름 없는 간격을 다르게 남기지 말고 선택한 값을 이름이 있는 설계 결정으로 기록합니다.

상태 이름뿐 아니라 상태의 규칙 쓰기

이메일이 비어 있을 때는 ‘이메일 주소를 입력해 주세요’, 이미 팀에 속한 주소에는 ‘이미 팀원으로 등록된 사용자입니다’라고 안내하고, 적절한 경우 해당 팀원 항목으로 연결합니다. 서비스 장애에는 다른 메시지와 재시도 경로가 필요합니다. 같은 빨간색 컴포넌트를 쓸 수 있다는 이유로 모든 폼에 ‘문제가 발생했습니다’를 표시하라고 안내해서는 안 됩니다.

제출 실패 뒤 무엇을 유지할지도 기록하세요. 입력한 주소와 선택한 역할을 남겨 사용자가 재시도하거나 수정할 수 있게 합니다. 시각적인 로딩 상태가 초대를 보냈다는 증거는 아닙니다. 성공 확인은 애플리케이션의 처리 결과에 따라 표시하고, 재시도 동작은 개발팀과 합의해야 합니다.

텍스트를 확대하고 간격을 변경한 폼을 디자인 파일뿐 아니라 구현된 화면에서도 확인하세요. WCAG 텍스트 간격 안내(영문)는 사용자가 간격을 바꿔도 콘텐츠와 기능을 유지하는 데 관한 지침입니다. 모든 디자인의 기본값을 해당 시험 설정으로 정하라는 의미는 아닙니다.

별도의 표준을 만들지 않고 예외 정리하기

간결한 팀원 목록 행에는 전체 폼보다 작은 ‘초대’ 버튼이 필요할 수 있습니다. 이름 없는 개별 버튼을 만들지 말고 사용 위치를 정한 특정 변형으로 기록하세요. 레이블이나 동작이 다르면 이유도 설명합니다. 작은 표에 컴포넌트, 승인된 변형, 이를 보여 주는 화면, 규칙 담당자를 정리할 수 있습니다.

필드 높이를 바꿀 때는 초대 폼, 계정 설정, 해당 필드를 사용하는 작은 대화상자를 함께 살펴보세요. 공유 에셋과 사용 설명을 함께 갱신한 뒤 영향을 받는 인스턴스와 구현을 확인합니다. 라이브러리를 바꾸는 일과 배포된 애플리케이션을 업데이트하는 일은 별개입니다. 결정과 적용 현황을 드러내어 서로 충돌하는 두 예시가 모두 공식 기준처럼 보이지 않게 하세요.

4. 참고할 UI 스타일 가이드 5가지

공개된 스타일 가이드는 많습니다. 좋아하는 브랜드나 앱의 자료를 찾아보면 참고할 만한 사례를 발견할 수 있습니다. 출발점으로 다음 다섯 가지 가이드를 살펴보세요.

1. Mozilla

Mozilla는 여러 인터페이스에서 알아보기 쉬운 정체성을 일관되게 유지한 역사적 사례로 유용합니다. Firefox OS 자료는 현재의 스마트폰 플랫폼 지침이 아닌 기록 자료로 보아야 합니다. Mozilla는 2016년 스마트폰 프로젝트 종료 계획을 발표했습니다(영문). 오래된 플랫폼 규칙을 복사하지 말고 지침의 구성 방식을 살펴보세요.

2. Apple Human Interface Guidelines

Apple의 Human Interface Guidelines(영문)는 플랫폼 지침이 인터페이스 요소와 동작을 어떻게 연결하는지 보여 줍니다. 브랜드 팔레트보다 범위가 넓습니다. 관련 플랫폼의 관례를 이해하는 데 활용하되 자체 제품에 필요한 결정도 따로 기록하세요.

3. Yelp

Yelp의 Cookbook(영문)은 기초 스타일을 컴포넌트, 템플릿, 페이지와 연결합니다. 배지, 버튼, 평점, 선택 항목 등의 예시를 통해 타이포그래피와 색상 규칙이 재사용 가능한 인터페이스 패턴으로 이어지는 방식을 배울 수 있습니다. Yelp의 시각적 정체성을 복사하기보다 이러한 연결 관계를 자체 가이드에 적용하세요.

4. Salesforce

Salesforce의 Lightning Design System 안내(영문)는 사용자 정의 Lightning 컴포넌트를 주변 Salesforce 인터페이스와 일관되게 만드는 방법을 설명합니다. 공유 스타일과 지원하는 변형 및 사용자 정의 방법을 구분합니다. 기존 제품을 확장하는 팀에 유용한 모델입니다. 모든 시각적 요소를 마음대로 바꿀 수 있다고 생각하지 말고 어떤 부분은 익숙하게 유지해야 하며 어디를 조정할 수 있는지 기록하세요.

5. Spotify

Spotify의 디자인 및 브랜딩 지침(영문)은 Spotify 콘텐츠를 연동하는 제품을 대상으로 합니다. 가이드가 제약과 그 배경을 설명하는 방식을 이해하는 데 유용합니다. 연동 지침을 완전한 사내 UI 시스템과 혼동하거나 관련 없는 콘텐츠에 해당 브랜드 요구사항을 적용하지 마세요.

5. Pixso에서 가이드 만들고 검토하기

Pixso 파일에서 기초 규칙과 이를 사용하는 화면을 나란히 배치합니다. 타이포그래피, 색상, 간격, 컴포넌트 섹션을 만들고 각 예시 옆에 실제 폼이나 설정 화면을 놓으세요. 검토자가 제안된 규칙으로 무엇이 바뀌는지 확인할 수 있습니다.

Pixso는 이 검토를 함께 진행할 디자인 작업 공간을 제공합니다. 컴포넌트 상태를 비교하고 불명확한 규칙을 논의하며 사용 설명을 디자인 옆에 남기세요. 라이브러리 에셋과 문서의 규칙은 역할이 다릅니다. 에셋은 재사용을 돕고, 규칙은 언제 재사용하는 것이 적절한지 설명합니다.

Pixso 브랜드 로고. 공유 파일에서 가이드 규칙과 실제 화면을 함께 검토합니다.

Pixso 브랜드 로고. 공유 파일에서 가이드 규칙과 실제 화면을 함께 검토합니다.이미지를 열어 확대

예를 들어 일반 입력 필드, 오류 상태, 긴 번역 레이블을 같은 검토 영역에 놓습니다. 팀에 간격, 대비, 문구를 함께 확인하도록 요청하세요. 다음 화면에서 같은 논의를 반복하지 않도록 결정 내용을 가이드에 기록합니다.

마무리

유용한 스타일 가이드는 반복되는 결정의 불확실성을 줄입니다. 팀이 이미 사용하는 패턴부터 시작하고 동작과 적용 범위를 설명하세요. 구현 과정에서 빠진 사례가 드러나면 지침을 수정합니다.

다음 Pixso 검토에서는 자주 사용하는 컴포넌트 하나를 골라 실제에 가까운 화면 옆에 각 상태를 기록해 보세요. 겉으로만 완성된 문서가 아니라 팀이 사용할 수 있는 가이드를 만드는 구체적인 토대가 됩니다.

맨 위로 이동
X에 공유하기
페이스북에 공유하기