본문으로 이동

Vercel UI SDK 대박인 이유, React와 Solid에서도 사용 가능하고 에이전트가 만들고 쓰는 UI

geul조회 6추천 0댓글 0
  • Vercel UI SDK(UI SDK)는 Vercel이 11월 13일(한국 시간) 공개한 UI 동작 라이브러리임. shadcn/ui를 만든 shadcn과 Shu Ding이 만듦

  • 키보드 이동, 포커스, 선택, 팝업, 드래그 앤 드롭과 접근성 속성을 대신 처리해 주고, 생김새는 직접 입힘

  • 무료(Apache-2.0)이고, React와 Solid는 물론 Vue, Svelte, Web Components에서도 같은 코드로 씀

  • 에이전트가 컴포넌트를 만들기 쉽고, 완성된 화면을 에이전트가 직접 조작할 수도 있다는 게 대박인 부분임

  • 아직 베타(0.1.0-beta.3)라서 실서비스보다는 새 프로젝트에서 먼저 써 볼 만함

Vercel UI SDK란, shadcn/ui와 뭐가 다른가

완성된 컴포넌트가 아니라 컴포넌트를 이루는 동작 조각을 주는 라이브러리임.

  • Select 하나를 뜯어 보면 팝업 띄우기, 항목 고르기, 글자 쳐서 찾기, 포커스 관리가 들어 있음

    • UI SDK는 이걸 createPopup, createSelection, createTypeahead처럼 따로 떼어 50개 넘게 제공함

  • 조각을 조합해 만든 완성 컴포넌트도 50개 넘게 있음. 버튼, 대화상자부터 날짜 선택, 이미지 자르기까지 있음

  • Radix나 Base UI처럼 디자인이 없는 headless(동작만 있고 생김새는 없는) 계열임

    • 다른 점은 목록에 없는 UI도 같은 조각으로 같은 품질을 낼 수 있다는 것

  • shadcn/ui는 디자인까지 입힌 컴포넌트 모음이고, UI SDK는 그 아래층에 해당함

    • X에는 "shadcn/ui가 UI SDK 위로 옮겨 오면 모든 프레임워크를 공식 지원할 수 있겠다"는 기대 글도 올라옴

React, Solid에서 쓰는 법

설치하고 import만 하면 됨. React와 Solid는 패키지 이름만 다름.

  • 설치: npm install @ui-sdk/react @ui-sdk/core (Solid는 @ui-sdk/solid)

  • 에이전트용 스킬도 함께 깔아 두면 Claude Code 같은 에이전트가 UI SDK 방식대로 짬

npx skills@latest add vercel-labs/ui --skill ui-sdk
  • 완성 컴포넌트 쓰기 (React)

import { Toggle } from "@ui-sdk/react/toggle"

function Example() {
  return (
    <Toggle className="rounded-md border px-2.5 py-1.5 data-pressed:bg-neutral-100">
      Bold
    </Toggle>
  )
}
  • Solid는 import 경로와 className 대신 class만 바뀜

import { Toggle } from "@ui-sdk/solid/toggle"

<Toggle class="rounded-md border px-2.5 py-1.5 data-pressed:bg-neutral-100">Bold</Toggle>
  • 목록에 없는 컴포넌트는 definePrimitive로 직접 만듦. 아래는 값이 있을 때만 지우기 버튼이 보이고, 누르면 포커스가 입력창으로 돌아가는 검색창임

import { createFocusRecovery, definePrimitive } from "@ui-sdk/core"

const searchField = definePrimitive({
  name: "search-field",
  state: () => ({ value: "" }),
  api: (context) => ({
    set: (value: string) => context.store.set({ value }),
    recovery: createFocusRecovery({ fallback: () => context.element("input") }),
  }),
  slots: (slot) => ({
    input: slot({
      attrs: (state) => ({ value: state.value }),
      on: { input: (e, { api }) => api.set((e.target as HTMLInputElement).value) },
    }),
    clear: slot({
      present: (state) => state.value !== "",
      attrs: () => ({ type: "button" }),
      press: ({ api }) => api.set(""),
      bind: (el, part) => part.api.recovery.bind(el, part),
    }),
  }),
})
  • 한 번 정의하면 프레임워크마다 createParts로 꺼내 씀. React는 @ui-sdk/react/primitive, Solid는 @ui-sdk/solid/primitive에서 가져옴

const parts = createParts(searchField, { input: "input", clear: "button" })

<parts.Root>
  <parts.Input placeholder="Search" />
  <parts.Clear>Clear</parts.Clear>
</parts.Root>

스타일링, 디자인은 어떻게 입히나

기본 디자인이 하나도 없고, 상태를 HTML 속성으로 붙여 주니 그 속성을 보고 CSS나 Tailwind로 꾸밈.

  • 부품마다 data-slot 이름표가 붙음. CSS에서 [data-slot="search-field-clear"]처럼 잡음

  • 상태가 바뀌면 data-open, data-pressed, data-disabled 같은 속성이 붙었다 떨어짐

    • Tailwind는 data-pressed:bg-neutral-100처럼 앞에 붙여 씀

  • 진행률 같은 숫자는 CSS 변수로 받음. 팝업 너비를 버튼에 맞추는 --anchor-width 같은 것

  • 열고 닫는 애니메이션은 data-starting-style, data-ending-style에 걸면 됨. 사라지는 애니메이션이 끝날 때까지 화면에 남겨 둠

  • 전역 CSS 맨 위에 @layer ui-sdk; 한 줄을 넣어야 내 스타일이 항상 이김

에이전트와 궁합이 미쳤다 싶은 이유

에이전트가 만들 때도, 완성된 화면을 쓸 때도 에이전트를 염두에 두고 설계함.

  • 만들 때

    • 패키지마다 설치한 버전에 맞는 문서가 들어 있어, 에이전트가 옛날 API로 짜는 일을 줄임

    • 키보드, 포커스, 접근성 속성이 맞는지 확인하는 테스트 도구가 있어 에이전트가 스스로 검사함

    • shadcn은 "영상 속 화면은 모두 에이전트가 한 번에 만들었고, 그대로 접근성 점수가 잘 나왔다"고 밝힘

  • 쓸 때

    • createAgent를 한 번 만들면, 에이전트가 화면 속 컴포넌트의 이름, 지금 값, 할 수 있는 동작을 목록으로 읽음

    • 스크린샷을 보고 클릭을 흉내 내지 않고, setValue 같은 컴포넌트 기능을 직접 부름

    • 어떤 동작을 허락할지 정하고, 중요한 버튼은 사람에게 먼저 묻게 할 수 있음

    • 에이전트가 바꾼 값을 기록했다가 되돌리는 기능도 있음 (실험 기능)

    • 브라우저에 내장된 AI가 쓸 수 있게 WebMCP(웹 페이지가 AI에게 도구를 알려 주는 브라우저 기능)로 등록할 수도 있음

개발자가 도입하면 얻는 것, 잃는 것

접근성과 키보드 처리에 쓰던 시간을 아끼고, 앱에 AI 기능을 붙이기 쉬워짐.

  • 얻는 것

    • 접근성 걱정이 줄어듦. 화면 읽기 프로그램용 속성, 방향키 이동, Esc로 닫기를 직접 짜지 않아도 됨

    • 디자인 시스템을 그대로 지킴. 디자인을 강요하지 않으니 기존 Tailwind 토큰을 그대로 씀

    • 특이한 UI도 품질이 같음. 좌석 선택표, 오디오 케이블 연결 화면 같은 것도 같은 조각으로 만듦

    • 프레임워크가 섞인 회사에서 컴포넌트 정의 하나를 React 팀과 Solid 팀이 함께 씀

    • 에이전트에게 UI 작업을 맡겨도 결과가 덜 들쭉날쭉함

    • 사내 도구나 서비스에 AI 비서를 붙일 때, 화면 조작용 도구를 하나하나 따로 만들 필요가 줄어듦

  • 잃는 것, 조심할 것

    • 베타라서 정식 출시 전에 API가 바뀔 수 있다고 공식 문서에 적혀 있음

    • 디자인은 직접 해야 함. 예쁜 기본 테마를 원하면 shadcn/ui 같은 걸 함께 써야 함

    • definePrimitive, slot 같은 개념에 익숙해지는 시간이 듦

    • 이미 Radix나 Base UI로 잘 돌아가는 서비스라면 갈아탈 이유는 아직 약함

X 반응과 공식 예제

발표 글은 사흘 만에 조회 85만을 넘겼고, 칭찬과 "왜 필요한지 모르겠다"는 의견이 함께 나옴 (11월 16일 확인).

  • Vercel 발표 글은 조회 85.7만, 좋아요 6.5천, 북마크 5.3천을 기록함

  • Vercel Labs의 Chris Tate는 에이전트가 만든 예제를 30초 영상으로 올림

    • LED 전광판처럼 점으로 찍은 별점

    • 벽에 붙은 조명 스위치 3개 (현관, 차고, 정원)

    • 옛날 TV 문자방송 화면에서 "WE"를 치면 Weather 항목이 걸러지는 검색

    • 글자를 치면 서체 목록이 걸러지는 서체 고르기

  • 공식 예제 모음(ui-sdk.dev/sink)에는 실제로 돌아가는 예제가 60개 넘게 있음

    • 명령 팔레트, 칸반 보드, 일정 캘린더, 비행기 좌석 고르기, 결제 폼, 1만 곡 목록 같은 것

  • 반론도 나옴

    • "에이전트가 어려워하는 건 동작이 아니라 디자인과 미감"이라는 글이 좋아요 65개를 받음

    • "처음엔 무슨 가치인지 알기 어려웠다, 홈페이지 설명을 손봐야 할 것 같다"는 의견도 있음

추천저장

댓글

댓글을 남겨 보세요
로그인한 뒤에 댓글을 올릴 수 있습니다로그인
댓글 불러오는 중
글쓰기