협업 & 프로세스

레이어/컴포넌트 이름 케밥 케이스 통일

피그마 오픈카톡방2026. 3. 7.

질문사항

레이어 네이밍을 케밥 케이스(kebab-case)로 표기하기로 했다면, 컴포넌트 이름도 케밥 케이스로 통일해야 할까요?

답변

레이어 네이밍을 케밥 케이스(kebab-case)로 사용하기로 했다면, 컴포넌트 이름도 일관성 있게 케밥 케이스로 통일하는 것이 좋습니다.

이유:

일관성 유지: 디자인 시스템이나 프로젝트 내에서 네이밍 컨벤션을 일관되게 유지하는 것은 매우 중요합니다. 이는 디자이너 간의 협업뿐만 아니라, 개발자와의 소통에서도 혼란을 줄여줍니다.

개발자 핸드오프 효율성: 개발자들은 디자인 파일의 레이어 및 컴포넌트 이름을 기반으로 코드를 작성하거나 참조하는 경우가 많습니다. 만약 디자인 파일 내에서 네이밍 컨벤션이 일관되지 않으면, 개발자가 필요한 요소를 찾거나 코드를 매칭하는 데 어려움을 겪을 수 있습니다. 케밥 케이스는 웹 개발에서 CSS 클래스명 등에 자주 사용되므로, 개발자에게 익숙한 형태일 수 있습니다.

검색 및 관리 용이성: 일관된 네이밍은 피그마 내에서 컴포넌트를 검색하거나 관리할 때도 효율성을 높여줍니다.

핵심은 '협의'입니다.

가장 중요한 것은 팀 내에서 (특히 개발팀과) 네이밍 컨벤션에 대해 명확히 협의하고 합의된 규칙을 따르는 것입니다. 만약 개발팀에서 컴포넌트 이름은 다른 컨벤션(예: PascalCase)을 선호한다면, 그에 맞춰 조정할 수도 있습니다. 하지만 일반적으로는 레이어와 컴포넌트 모두 동일한 컨벤션을 따르는 것이 가장 혼란을 줄이는 방법입니다.

따라서, 레이어 네이밍을 케밥 케이스로 하기로 했다면, 컴포넌트 이름도 케밥 케이스로 통일하는 것을 강력히 권장합니다.