WBDS 01
WBDS 01 DOCUMENTATION

Browse the system

Navigation loads from the WBDS 01 Docs manifest.

WBDS 01 SEARCH

Find documentation

Type to search the WBDS 01 documentation hierarchy.

Getting Started

Adoption & Contributing

WBDS를 제품에 적용할 때 어디서 시작하고, 무엇을 확인한 뒤 범위를 넓힐지 정리합니다.

어디서 시작할까요?

처음부터 전체 제품을 바꾸지 않습니다.

작게 시작합니다.

동작과 데이터는 그대로 둔 채, 한 화면이나 한 작업 흐름에서 WBDS가 실제로 잘 맞는지 먼저 확인합니다.

적용 순서

기존 제품을 망가뜨리지 않고 가져오는 순서입니다.

  1. 먼저 기존 화면의 동작과 데이터 흐름을 확인합니다.
  2. 한 화면이나 한 작업 흐름처럼 범위를 작게 잡습니다.
  3. 로컬 색상과 간격을 그대로 옮기지 않고 WBDS token과 기존 컴포넌트에 맞춰 바꿉니다.
  4. 필요한 컴포넌트나 동작이 없으면 제품 안에서 임의의 변형을 만들지 않고 WBDS의 부족한 점으로 남깁니다.
  5. 키보드, 포커스, 작은 화면, 로딩·빈 상태·오류 상태까지 함께 확인합니다.
  6. 적용 결과에서 생긴 문제와 개선점을 다음 WBDS 작업에 반영합니다.

범위를 넓히기 전에

다음 항목은 충분히 검증한 뒤에 진행합니다.

  • 처음부터 제품 전체를 바꾸지 않습니다.
  • 기존 동작이나 데이터 흐름을 디자인 변경 때문에 바꾸지 않습니다.
  • 참고한 디자인 시스템의 패턴을 이유 없이 그대로 가져오지 않습니다.
  • WBDS에 없는 동작을 제품마다 제각각 추가하지 않습니다.
  • 검증하지 않은 컴포넌트를 Stable처럼 취급하지 않습니다.
  • 리뷰 없이 Production이나 main으로 바로 올리지 않습니다.
참고 문서 3
AdoptionConsumer integration v0.6WBDS package guide