Vercel UI SDK 대박인 이유, React와 Solid에서도 사용 가능하고 에이전트가 만들고 쓰는 UI
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개를 받음
"처음엔 무슨 가치인지 알기 어려웠다, 홈페이지 설명을 손봐야 할 것 같다"는 의견도 있음
댓글