본문으로 건너뛰기
언어

webkit 과 uikit

핸디즈 웹 앱이 함께 쓰는 사내 키트 둘을, 앱 팀이 받아 쓰는 방식 그대로 문서로 만든 사이트입니다.

webkit

사내 레지스트리의 npm 패키지입니다. API 클라이언트와 인증, 다국어, 날짜·값 형식, 앱 WebView 브릿지, Next 공통 조각, 브라우저 도구, 표 데이터, HTML 거르기, 린트·E2E 설정을 담습니다.

webkit 패키지 보기

uikit

Base UI 와 Tailwind CSS v4 위의 React UI 아이템 레지스트리(shadcn registry)입니다. shadcn CLI 로 앱에 소스를 복사해 넣으며 webkit 패키지 위에서 돕니다.

uikit 아이템 보기

앱이 붙이는 순서

  1. 앱이 사내 npm 레지스트리를 바라보게 하고, 읽기 토큰은 사용자 설정에 둡니다.
  2. 앱에 필요한 webkit 패키지를 받습니다. 설정 프리셋을 먼저, 그다음 next·i18n·format·time 을 받습니다.
  3. shadcn(base-nova, Base UI)을 준비하고 components.json 에 태그로 고정한 @uikit 레지스트리를 더합니다.
  4. 기초 아이템 style 과 locale 을 받고 앱을 LocaleProvider 로 감쌉니다.
  5. 화면에 필요한 uikit 아이템을 하나씩 받습니다. 받기 전에 아이템 README 를 먼저 읽습니다.