이 글의 내용
김희준
김희준

2026년 11월 16일 업데이트

폼, 표, 반복되는 동작이 있는 대시보드는 각 컨트롤이 같은 규칙을 따를 때 유지관리하기 쉽습니다. Ant Design 키트는 Figma 프로젝트에서 재사용할 출발점이 될 수 있습니다. 다만 샘플 화면의 모양만큼 키트의 버전, 라이선스, 컴포넌트 구조도 중요합니다.

이 글에서는 ‘Ant Design for Figma’가 무엇을 뜻하는지, 키트를 디자인 파일로 가져오는 방법, 개발에 전달할 정보를 준비하는 방법을 설명합니다. 다른 협업 공간에서 작업을 이어가려는 팀을 위해, 사용 권한이 있는 키트를 Pixso의 디자인 시스템 작업 방식으로 시험하는 방법도 다룹니다.

Ant Design과 Figma: React 디자인 시스템과 그와 별개로 제공되는 타사 디자인 리소스입니다.

Ant Design과 Figma: React 디자인 시스템과 그와 별개로 제공되는 타사 디자인 리소스입니다.이미지를 열어 확대

1. Ant Design for Figma란?

Ant Design은 React 컴포넌트 라이브러리를 갖춘 디자인 시스템입니다. 이를 따르는 Figma 키트는 별도의 디자인 리소스입니다. 공식 리소스 목록 (영어)도 등록된 Figma 리소스를 타사 제작물로 표시합니다. 예를 들어 Matt Wierzbicki의 Ant Design System for Figma (영어)에는 버튼, 입력 필드, 체크박스, 표, 아이콘 등 재사용 가능한 UI 요소가 들어 있습니다.

Ant라는 이름이 붙은 파일을 모두 같은 제품으로 보지 말고, 키트를 평가할 때 다음 세 가지를 살펴보세요.

  • 컴포넌트 범위: 제품에 필요한 컨트롤과 상태가 포함돼 있는지 확인합니다. 판매자는 현재 2,000개 이상의 컴포넌트·블록과 800개 이상의 아이콘을 안내합니다. 그러나 실제로 중요한 것은 구입하거나 내려받는 에디션에 필요한 표, 폼, 상호작용 상태가 들어 있는지입니다.
  • 사용자화: 색상, 타이포그래피, 컴포넌트 속성을 어떻게 구성했는지 살펴봅니다. 모든 인스턴스를 분리해 화면마다 수동으로 수정하기보다 공유 스타일, 변수, 메인 컴포넌트를 변경하는 방식을 우선하세요.
  • 레이아웃과 상태: 위 키트는 Auto Layout, 변수, 배리언트 지원을 안내합니다. 실제 컴포넌트에 긴 라벨과 좁은 컨테이너를 적용해 보세요. 반응형 디자인 구성이 있더라도 배치 규칙과 필요한 상태는 의도적으로 설계해야 합니다.

2. 재사용 가능한 Ant Design 키트의 장점

주요 이점은 재사용과 공통 기준에서 나옵니다. 키트를 서로 관계없는 이미지 폴더로 취급하지 않고 팀이 일관되게 관리해야 그 이점을 얻을 수 있습니다.

반복되는 준비 작업 줄이기

화면마다 같은 컨트롤을 그리는 대신 적합한 입력 필드, 버튼, 표에서 시작할 수 있습니다. 줄어든 준비 시간을 콘텐츠, 오류 처리, 제품의 작업별 차이를 설계하는 데 쓰세요. 키트를 사용한다고 이런 판단까지 자동으로 정해지지는 않습니다.

반복되는 컨트롤의 일관성 유지하기

반복되는 동작에는 같은 컴포넌트의 인스턴스를 쓰고 합의한 글꼴·색상 토큰을 적용합니다. 공유 컨트롤이 바뀌면 이를 사용하는 화면에 미치는 영향을 검토하세요. 개별 오버라이드가 모르는 사이 또 하나의 디자인 기준으로 굳어지는 일을 방지할 수 있습니다.

예제를 출발점으로 활용하기

샘플 화면은 적절한 표 밀도, 폼의 그룹 구성, 글자 계층을 정하는 데 도움이 됩니다. 템플릿이 시각적으로 완성돼 있다는 이유로 샘플 내용을 그대로 남기지 말고, 실제 정보와 사용자 작업에 맞게 바꾸세요.

디자이너와 개발자의 공통 참조 만들기

이름이 있는 컴포넌트와 명시된 상태는 이름 없는 사각형보다 논의하기 쉽습니다. 디자인 키트를 애플리케이션이 사용하는 Ant Design 버전에 맞추고, 특수한 동작에는 구현 결정을 연결하세요. Figma 키트는 React 라이브러리 자체가 아니며 해당 애플리케이션을 자동으로 생성하지도 않습니다.

3. Figma에서 Ant Design 키트 사용하기

가져오기 전에 제작자, 에디션, 라이선스, 지원하는 Ant Design 버전을 확인합니다. Community 샘플은 상용 키트보다 컴포넌트 수가 적을 수 있습니다. 파일 사용 허가가 재배포 허가까지 포함하는 것은 아닙니다.

1단계: 키트 가져오기 또는 복제하기

제작자가 안내한 배포 경로에서 파일을 받으세요. Community 리소스라면 해당 리소스의 복제 기능을 사용합니다. 판매자가 .fig 파일을 제공하면 Figma의 파일 브라우저 가져오기 (영어)를 이용하거나 파일을 그곳으로 드래그합니다. 내려받은 압축 파일에 지원되는 디자인 파일이 들어 있을 때 압축을 푸세요. 임의의 컴포넌트나 ZIP을 캔버스에 놓는 것은 같은 작업이 아닙니다.

내려받은 패키지에 포함된 Figma 키트 파일입니다. 지원되는 디자인 파일을 Figma 파일 브라우저에서 가져오세요.

내려받은 패키지에 포함된 Figma 키트 파일입니다. 지원되는 디자인 파일을 Figma 파일 브라우저에서 가져오세요.이미지를 열어 확대

출처: Mateusz Wierzbicki. 키트의 이전 배포 화면입니다.

2단계: 작업 파일에서 컴포넌트 재사용하기

가져온 키트를 열어 메인 컴포넌트, 스타일, 변수를 살펴봅니다. 파일 간 재사용이 필요하다면 사용 중인 Figma 플랜과 권한이 지원하는 경우에만 라이브러리를 게시하고 활성화하세요. Starter에는 팀 라이브러리가 없습니다. 지원되지 않는 경우 허용된 파일 구조 안에서 작업합니다. Assets에서 컴포넌트 인스턴스를 삽입하고 적합한 배리언트를 선택한 뒤, 재사용 관계를 유지하면서 속성을 조정하세요.

키트의 재사용 가능한 컴포넌트로 만든 청구서 표입니다. 이전 Figma 화면을 사용했습니다.

키트의 재사용 가능한 컴포넌트로 만든 청구서 표입니다. 이전 Figma 화면을 사용했습니다.이미지를 열어 확대

출처: Mateusz Wierzbicki. 키트의 컴포넌트를 재사용하고 자신의 레이아웃에서 각 상태를 확인하세요.

3단계: 전체 작업을 미리 보기

템플릿을 수정하거나 필요한 화면을 만든 뒤, 작업 흐름을 설명할 프로토타입 연결을 추가합니다. Figma의 Preview 또는 Present (영어) 모드로 흐름을 따라가세요. 휴대폰 레이아웃은 현재 Figma 모바일 앱이나 모바일 프로토타입 링크 (영어)로 확인합니다. 대상 기기에서 라벨, 넘침, 오류 복구를 점검하세요. 데스크톱 미리 보기만으로 모바일 사용성을 판단할 수는 없습니다.

이전 Figma 화면의 키트 레이아웃입니다. 현재 Preview 또는 Present 기능으로 실제 작업을 연결하고 재생하세요.

이전 Figma 화면의 키트 레이아웃입니다. 현재 Preview 또는 Present 기능으로 실제 작업을 연결하고 재생하세요.이미지를 열어 확대

출처: Mateusz Wierzbicki. 이전 미리 보기 예제는 배치 참고용입니다. 현재 Figma는 Preview/Present와 Figma 모바일 앱을 사용합니다.

예제: 관리자 표에서 사용자 만들기

사용자 추가 동작이 있는 표와 이름·이메일 입력 필드가 있는 폼을 만듭니다. 필수 항목이 빈 상태, 제출 대기 상태, 성공 결과를 포함하세요. 이는 디자인을 검증하기 위한 예제이며, 가져온 키트가 이미 동작하는 백엔드를 구현한다는 뜻은 아닙니다.

디자인 상태검토자에게 보여야 할 내용개발 전달 사항
기본명확한 입력 라벨과 하나의 주요 제출 동작.실제로 사용할 입력·버튼 컴포넌트와 필요한 데이터를 지정합니다.
유효성 검사 오류수정할 필드 옆에 구체적인 메시지를 표시합니다.검증 규칙과 오류 메시지 동작을 정의합니다. Ant Design Form 문서 (영어)를 참고하세요.
제출 중실수로 반복 제출하는 것을 막는 대기 상태.버튼의 loading·disabled 상태 (영어)가 언제 시작되고 끝나는지 설명합니다.
성공 또는 실패새 행을 표시하거나 재시도할 수 있는 오류를 안내합니다.결과를 실제 데이터와 연결하고 입력한 값을 어떻게 처리할지 정합니다.

폼 크기를 바꾸고 이름을 긴 값으로 교체한 뒤 표에서부터 작업을 따라가세요. 키트에 필요한 상태가 없다면 관련 없는 배리언트로 대신하지 말고 직접 만들고 문서화합니다. 그래야 시각적 리소스와 애플리케이션의 동작을 맞출 수 있습니다.

4. Pixso에서 키트 평가하기

팀이 Pixso에서 공동 디자인 작업을 하려면 사용 권한이 있는 Figma 또는 Sketch 사본을 안내된 가져오기 경로로 불러오세요. 키트 전체를 옮기기 전에 대표 컴포넌트 하나와 그 상태를 비교합니다. 가져오기 지원이 모든 변수, 배리언트, 라이브러리 연결, 프로토타입 동작을 제품 간에 동일하게 옮긴다는 보장은 아닙니다.

Pixso 커뮤니티 리소스 탐색 화면입니다. 선택한 리소스의 제작자, 라이선스, 버전을 확인하세요.

Pixso 커뮤니티 리소스 탐색 화면입니다. 선택한 리소스의 제작자, 라이선스, 버전을 확인하세요.이미지를 열어 확대

Pixso 커뮤니티에서도 관련 디자인 리소스를 찾을 수 있지만, 각 리소스의 제작자, 라이선스, 버전, 포함 범위를 확인해야 합니다. 실제로 고른 리소스로 작은 폼을 만들어 리뷰용으로 공유하고, Dev View에서 승인된 상태를 살펴보세요. 무료 계정에 모든 기능이 포함된다고 가정하지 말고, 편집·라이브러리·개발 전달에 필요한 플랜과 역할을 사용합니다.

키트를 지속적으로 관리하는 디자인 리소스로 활용하기

Ant Design 키트는 사용 버전, 공유 컴포넌트를 변경하는 방법, 각 상태가 나타내는 구현 동작을 팀이 기록할 때 가장 유용합니다. 이후 수정 내용을 검토하기 쉬워지고, 세련된 템플릿 뒤에 미결정 제품 사항이 가려지는 일도 방지할 수 있습니다.

애플리케이션에 맞는 키트를 선택하고 가능한 한 인스턴스 연결을 유지하세요. 제품 전체로 확장하기 전에 실제 작업 하나를 검증합니다. Figma든 Pixso든 목표는 다음 팀원이 이해하고 수정하고 구현할 수 있는 디자인입니다.

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