Foundations

Spacing

모든 컴포넌트가 따르는 spacing scale + breakpoint 별 responsive 규칙. 엔터프라이즈 Responsive Spacing System 패턴 참고 (SAP UI5 등).

Scale

Tailwind 의 4px 단위 scale 을 그대로 사용 — 0 / 4 / 8 / 12 / 16 / 24 / 32 / 48 / 64 / 96 px.

TokenpxTailwindUse case
00p-0맞붙임 (border-collapse 등)
14p-1아이콘 padding, tight 컬럼
28p-2버튼 내부, 작은 chip
312p-3card padding 모바일, list item
416p-4기본 padding — card 내부
520p-5section padding 좁은 화면
624p-6card padding 데스크탑
832p-8page 좌우 padding 태블릿
1040p-10Hero 박스 내부
1248p-12page padding 데스크탑
1664p-16Hero 상하 여백
2496p-24큰 vertical rhythm — 마케팅

Responsive breakpoints

4단계 — Mobile / Tablet / Desktop / Wide. Tailwind 의 sm md lg xl 2xl prefix 와 매핑.

BreakpointRangePaddingGapSection
Mobile< 640pxp-4 (16px)gap-3 (12px)py-12 (48px)
Tablet640–1023pxp-6 (24px)gap-4 (16px)py-16 (64px)
Desktop1024–1535pxp-8 (32px)gap-6 (24px)py-20 (80px)
Wide≥ 1536pxp-12 (48px)gap-8 (32px)py-24 (96px)

단일 className 으로 일괄 적용 예: p-4 sm:p-6 lg:p-8 xl:p-12

시각 비교

같은 카드를 4단계 padding 으로 나란히.

p-3
p-4
p-6
p-8

Do

  • spacing scale 안에서만 선택 (p-4, p-6 — p-5 회피).
  • breakpoint 별 responsive 클래스 사용 (예: `p-4 md:p-6 lg:p-8`).
  • card padding 은 컨테이너 사이즈에 비례.
  • icon-only 버튼은 size:9~10 + padding 0 (size 자체로 hit area 확보).

Don't

  • 임의 픽셀 값 (`p-[18px]`) — 디자인 일관성 깨짐.
  • 모바일에서도 데스크탑과 같은 padding (p-12 같은 큰 값) 강제.
  • section 사이 margin 으로 분리 (gap 또는 padding 우선).
  • border 와 spacing 을 혼동 — border 는 시각적 구분, spacing 은 호흡.

컴포넌트에 적용

Groudit UI 의 모든 컴포넌트는 이 spacing scale 위에 빌드됩니다. 자기 페이지에 추가 컴포넌트를 만들 때는 같은 token 만 사용하세요 — 임의 픽셀 값 (p-[18px]) 회피.