UI SDK vs Base UI vs Radix: 무엇을 선택할까요

TMT

https://hextaui.com/blog/ui-sdk-vs-base-ui-vs-radix

이번 주까지만 해도 shadcn/ui 스타일의 컴포넌트 라이브러리 아래에 깔리는 프리미티브 계층을 고르려면 Radix와 Base UI, 두 가지 중 하나를 선택해야 했습니다. 2026년 11월 12일, Vercel Labs가 세 번째 선택지인 UI SDK를 0.1.0-beta.1 버전으로 공개했습니다. 다른 두 라이브러리처럼 헤드리스 방식이지만, 설계의 출발점이 다르고 나머지 둘에는 없는 기능도 제공합니다. AI 에이전트가 컴포넌트를 읽고 조작할 수 있게 해 주는 브리지입니다.

비교에 앞서 밝혀 둘 점이 있습니다. 현재 HextaUI의 컴포넌트는 Base UI를 기반으로 하며, 여기에 별도의 UI SDK 버전을 추가하고 있습니다. 둘 다 좋아할 만한 이유가 있는 만큼 공정하게 비교하려고 노력했습니다. 아래의 모든 주장은 각 라이브러리의 문서, npm 메타데이터, 또는 같은 컴포넌트를 세 번 구현해 본 실험용 앱에 근거합니다.

shadcn/ui 코드에서 바뀌는 API를 하나하나 살펴보며 Radix에서 Base UI로 이전하는 과정을 자세히 알고 싶으시다면, 먼저 shadcn/ui가 Base UI로 전환했습니다를 읽어 보세요. 이 글에서는 그 내용을 반복하지 않습니다. UI SDK까지 비교에 넣고 무엇으로 시작하면 좋을지 살펴보겠습니다.

간단히 말씀드리면

  • Radix를 선택하세요. 이미 잘 작동하는 Radix 코드베이스가 있고, 팀이 익숙하게 쓰며, Radix에 없는 컴포넌트가 필요하지 않다면 적합합니다. 안정 버전이며, React 전용이고, MIT 라이선스입니다.
  • Base UI를 선택하세요. 이번 분기에 안정된 API로 출시할 새 React 디자인 시스템을 만든다면 적합합니다. 새로운 shadcn/ui 프로젝트의 기본 기반이며, Radix보다 더 많은 컴포넌트를 제공하고, 생태계 대부분이 옮겨 가는 속성 모델을 사용합니다.
  • UI SDK를 선택하세요. React 외의 프레임워크도 지원해야 하거나, 별도 라이브러리 없이 Color Picker, Date Picker, Tree 같은 컴포넌트가 필요하거나, 구조화된 도구를 통해 AI 에이전트가 UI를 조작하게 하고 싶다면 적합합니다. 다만 베타라는 점은 받아들여야 합니다.

이제 그 근거를 살펴보겠습니다.

세 라이브러리 한눈에 보기

RadixBase UIUI SDK
패키지radix-ui 1.8.1@base-ui/react 1.9.0@ui-sdk/react 0.1.0-beta.1
라이선스MITMITApache-2.0
상태안정 버전안정 버전베타
프레임워크ReactReactReact, Vue, Svelte, Solid, Web Components
열린 상태data-state="open"data-opendata-open
진입과 퇴장data-state에 적용하는 키프레임data-starting-style, data-ending-styledata-starting-style, data-ending-style
각 구성 요소의 data-slot없음없음있음
팝업 구성 요소Portal, ContentPortal, Positioner, Popup최상위 레이어의 Content
에이전트 브리지없음없음있음, WebMCP 사용

2026년 11월 기준 Radix, Base UI, UI SDK 비교

세 라이브러리 모두 기본 스타일을 제공하지 않으며, 포커스와 키보드 조작, ARIA 처리를 맡아 줍니다. 비교한 버전은 2026년 11월 13일 기준 npm의 최신 버전인 radix-ui 1.8.1(2026년 10월 12일 배포), @base-ui/react 1.9.0(2026년 10월 9일 배포), @ui-sdk/react 0.1.0-beta.1(2026년 11월 12일 배포)입니다.

서로 다른 세 가지 설계 모델

Radix는 컴포넌트마다 하나의 프리미티브를 제공합니다. Dialog 패키지는 Root, Trigger, Portal, Overlay, Content, Title, Description, Close를 제공하며, 개발자는 이 단위로 작업합니다. 포커스를 내부에 가두거나 팝업을 닫는 등의 동작은 내부에서 처리합니다. radix-ui 패키지는 이 프리미티브를 모두 묶어서 제공합니다.

Base UI도 컴포넌트 하나가 여러 구성 요소로 나뉘는 같은 구조입니다. 여기에 useRender, mergeProps 같은 공개 유틸리티를 더해, 기본 구성 요소와 같은 방식으로 동작하는 구성 요소를 직접 만들 수 있습니다. React 전용이며, Radix, Material UI, Floating UI 개발에 참여했던 사람들이 만들었습니다.

UI SDK는 계층을 다르게 나눕니다. @ui-sdk/core는 포커스 이동, 입력한 문자에 맞는 항목 탐색, 팝업, 드래그 앤 드롭, 스크린 리더 알림 등 다양한 동작을 제공하는 TypeScript 라이브러리입니다. 프리미티브는 definePrimitive를 통해 이런 동작에 상태와 이름 붙은 슬롯을 결합합니다. @ui-sdk/react에서 가져오는 컴포넌트는 React 어댑터로 렌더링한 프리미티브이며, 같은 프리미티브를 각 어댑터를 통해 Vue, Svelte, Solid, Web Components에서도 렌더링할 수 있습니다. 문서에서는 이 구조를 에이전트 활용과 연결해 설명합니다. 검증된 동작을 에이전트에게 주면, 아이콘 선택기나 칸반 보드처럼 라이브러리에서 제공하지 않는 컴포넌트도 만들 수 있다는 것입니다.

실무에서의 차이는 이렇습니다. Radix와 Base UI에 필요한 컴포넌트가 없다면 처음부터 직접 해결해야 합니다. UI SDK에서는 기본 컴포넌트가 사용하는 것과 같은 동작을 조합해 만들 수 있고, 그렇게 만든 컴포넌트도 에이전트 브리지에 연결할 수 있습니다.

같은 팝오버, 세 가지 구조

Vite 앱에서 같은 Tailwind 클래스를 사용해 팝오버 하나를 세 번 구현했습니다. 서로 다른 부분만 남긴 컴포넌트 트리는 다음과 같습니다.

import { Popover as BasePopover } from "@base-ui/react/popover"
import {
  Popover,
  PopoverContent,
  PopoverTitle,
  PopoverTrigger,
} from "@ui-sdk/react/popover"
import { Popover as RadixPopover } from "radix-ui"

function RadixVersion() {
  return (
    <RadixPopover.Root>
      <RadixPopover.Trigger className={trigger}>Radix</RadixPopover.Trigger>
      <RadixPopover.Portal>
        <RadixPopover.Content
          align="start"
          sideOffset={8}
          className={\`${panel} origin-(--radix-popover-content-transform-origin) data-[state=open]:animate-[popover-in_150ms_ease-out] data-[state=closed]:animate-[popover-out_100ms_ease-in]\`}
        >
          <p className="font-medium">Share project</p>
        </RadixPopover.Content>
      </RadixPopover.Portal>
    </RadixPopover.Root>
  )
}

function BaseUIVersion() {
  return (
    <BasePopover.Root>
      <BasePopover.Trigger className={trigger}>Base UI</BasePopover.Trigger>
      <BasePopover.Portal>
        <BasePopover.Positioner align="start" sideOffset={8}>
          <BasePopover.Popup
            className={\`${panel} origin-(--transform-origin) transition-[opacity,scale] duration-150 data-starting-style:scale-95 data-starting-style:opacity-0 data-ending-style:scale-95 data-ending-style:opacity-0\`}
          >
            <BasePopover.Title className="font-medium">
              Share project
            </BasePopover.Title>
          </BasePopover.Popup>
        </BasePopover.Positioner>
      </BasePopover.Portal>
    </BasePopover.Root>
  )
}

function UISDKVersion() {
  return (
    <Popover>
      <PopoverTrigger className={trigger}>UI SDK</PopoverTrigger>
      <PopoverContent
        align="start"
        sideOffset={8}
        className={\`${panel} origin-(--transform-origin) transition-[opacity,scale] duration-150 data-starting-style:scale-95 data-starting-style:opacity-0 data-ending-style:scale-95 data-ending-style:opacity-0\`}
      >
        <PopoverTitle className="font-medium">Share project</PopoverTitle>
      </PopoverContent>
    </Popover>
  )
}

trigger와 panel은 공통으로 쓰는 클래스 문자열이며, Radix 버전은 진입과 퇴장을 처리하는 짧은 @keyframes 규칙 두 개를 사용합니다. 세 버전의 결과는 똑같이 보입니다.

실험용 앱에서 캡처한 Radix, Base UI, UI SDK 팝오버입니다. 픽셀은 같지만 DOM과 코드는 다릅니다.

Radix

  • Popover.Root
  • Popover.Trigger
  • Popover.Portal
  • Popover.Content

Base UI

  • Popover.Root
  • Popover.Trigger
  • Popover.Portal
  • Popover.Positioner
  • Popover.Popup

UI SDK

  • Popover
  • PopoverTrigger
  • PopoverContent: 원래 위치에서 최상위 레이어에 렌더링

팝업을 옮기거나 위치를 잡기 위해 존재하는 구성 요소

같은 팝오버를 이루는 세 가지 구성 요소 트리

차이는 콘텐츠가 어디에 놓이느냐에 있습니다. 테스트에서 Radix와 Base UI는 모두 Portal을 통해 열린 콘텐츠를 <body>의 맨 끝으로 옮겼습니다. UI SDK는 popover="manual"을 사용해 콘텐츠를 자기 컴포넌트 안에 그대로 두었고, 브라우저가 이를 최상위 레이어로 올렸습니다. 이에 따라 몇 가지 차이가 생깁니다.

  • 겹침 순서를 두고 씨름할 필요가 없습니다. 최상위 레이어의 콘텐츠는 고정 헤더나 transform이 적용된 부모의 z-index가 얼마든 페이지 위에 표시됩니다.
  • 이벤트가 컴포넌트 트리를 따라 버블링합니다. UI SDK 문서에서는 팝업을 감싼 요소에 클릭 핸들러나 링크가 있으면 팝업 내부의 클릭도 전달된다고 경고합니다. 팝업은 클릭 가능한 카드 바깥에 두세요.
  • 감싸는 구성 요소가 줄어듭니다. side, align, sideOffset 같은 배치 props는 Positioner가 아니라 콘텐츠에 지정합니다.

Radix와 Base UI는 수년간 포털을 잘 처리해 왔으므로, 첫 번째 차이는 문제를 해결한다기보다 구조를 단순하게 만든다는 의미에 가깝습니다. 두 번째는 알아 두어야 할 새로운 동작입니다.

스타일링에 쓰는 속성과 변수

세 라이브러리 모두 data 속성으로 상태를 표시하지만 이름이 다르며, 모든 구성 요소에 이름을 붙이는 것은 하나뿐입니다.

속성·변수RadixBase UIUI SDK
열린 상태data-state="open"data-opendata-open
구성 요소 이름없음없음모든 구성 요소에 data-slot 제공
변형 기준점--radix-popover-content-transform-origin--transform-origin--transform-origin
앵커 너비--radix-popover-trigger-width--anchor-width--anchor-width
`className`에서 상태 사용불가상태를 받는 함수상태를 받는 함수

data-slot 항목은 보기보다 중요합니다. Radix와 Base UI가 이 속성을 출력하지 않기 때문에, shadcn/ui는 래퍼 파일에서 자체적으로 data-slot 속성을 추가합니다. 실험용 앱에서 Base UI 팝업에는 data-open, data-side, data-align이 있었고, data-slot은 없었습니다. UI SDK는 data-slot="popover-content"처럼 모든 구성 요소에 이 속성을 직접 설정하며, 문서에서는 props로 덮어쓸 수 없는 관리 속성으로 설명합니다. 덕분에 전역 CSS와 에이전트는 각 구성 요소를 일관된 이름으로 식별할 수 있습니다.

Tailwind로 스타일을 지정한다면 Base UI에서 UI SDK로 옮기는 작업은 대부분 래퍼를 제거하는 일입니다. 팝업의 속성 이름이 같기 때문입니다. Radix에서 옮길 때는 data-[state=open]: 변형과 Radix 접두사가 붙은 변수를 바꿔야 합니다. UI SDK 스타일링 튜토리얼에서는 shadcn 스타일 토큰을 사용해 컴포넌트 네 개를 살펴봅니다.

애니메이션

Radix는 data-state에 적용한 CSS 애니메이션으로 마운트와 언마운트를 표현합니다. 문서에 따르면 퇴장 애니메이션이 재생되는 동안에는 언마운트를 미룹니다. JavaScript 애니메이션 라이브러리를 위해 많은 구성 요소가 forceMount를 지원하므로, 애니메이션 라이브러리가 자식 요소의 마운트 시점을 결정할 수 있습니다.

Base UI는 data-starting-style과 data-ending-style을 추가해, 키프레임뿐 아니라 CSS 트랜지션으로도 양방향 애니메이션을 구현할 수 있게 합니다. 팝업은 애니메이션이 끝날 때까지 마운트된 상태를 유지한 뒤 제거되며, Portal에 keepMounted가 있으면 숨겨집니다. 애니메이션 가이드는 Motion도 다루며, opacity가 포함된 Motion 애니메이션을 감지한다고 설명합니다.

UI SDK도 같은 두 속성을 같은 의미로 사용합니다. 콘텐츠는 퇴장 트랜지션이나 애니메이션이 끝날 때까지 마운트된 상태를 유지합니다. keepMounted를 쓰면 닫힌 콘텐츠도 페이지에 남고, 열기나 닫기가 끝나면 onOpenChangeComplete가 실행됩니다. UI SDK 문서에는 아직 Motion 가이드가 없습니다. 애니메이션 라이브러리 때문에 닫힌 콘텐츠를 DOM에 남겨야 한다면 keepMounted를 사용하라는 안내만 있습니다.

CSS만으로 애니메이션을 구현한다면 Base UI와 UI SDK는 사실상 같습니다. Motion을 많이 쓰는 인터페이스라면 현재 Base UI에는 문서화된 구현 패턴이 있고, UI SDK에는 없습니다.

제공하는 컴포넌트 범위

라이브러리마다 컴포넌트를 나누고 이름 붙이는 방식이 달라 개수를 정확하게 비교하기는 어렵습니다. 대략적인 기준은 다음과 같습니다.

  • Radix: radix-ui 1.8.1에 Accordion부터 Tooltip까지 프리미티브 패키지 30개가 있으며, Slot, Portal, Visually Hidden 같은 유틸리티도 제공합니다.
  • Base UI: 문서 목차에 컴포넌트 37개가 있으며, Radix에는 없는 Combobox, Autocomplete, Number Field, OTP Field, Drawer, Toast, Preview Card도 포함합니다.
  • UI SDK: 0.1.0-beta.1에 포함된 문서를 기준으로 컴포넌트 55개와 훅 두 개를 제공합니다.

Base UI 컴포넌트 대부분은 UI SDK에도 대응하는 컴포넌트가 있습니다. 이름이 다를 때도 있습니다. Number Field는 Number Input, Preview Card는 Hover Card, OTP Field는 OTP Input입니다. UI SDK는 다른 두 라이브러리에 없는 Calendar, Date Picker, Date Input, Time Input, Color Picker, Rating, Tree, Command, Carousel, Resizable, Image Cropper, File Input, Token Input, Trigger Menu, Timeline, Waterfall도 제공합니다.

개수가 품질을 뜻하지는 않습니다. Radix와 Base UI의 컴포넌트는 수년간 실제 서비스에서 사용되어 왔습니다. UI SDK의 컴포넌트 문서에는 테스트한 동작이 항목별로 나열되어 있고, 이는 좋은 신호입니다. 하지만 공개된 지 하루가 된 것과 수년간 버그 보고를 받아 온 것은 같지 않습니다.

에이전트 브리지

이 기능은 UI SDK에만 있습니다. @ui-sdk/react/agent의 createAgent()는 페이지에 있는 모든 UI SDK 컴포넌트에 연결됩니다. snapshot()은 컴포넌트의 레이블, 상태, 실행 가능한 동작을 목록으로 보여 줍니다. act()는 각 컴포넌트의 API를 통해 해당 동작을 호출하며, 변경 콜백에서는 details.source === "agent"로 이를 확인할 수 있습니다. registerTools()는 WebMCP를 통해 브라우저에 내장된 에이전트에도 같은 도구를 제공합니다.

Radix와 Base UI에는 이런 기능이 내장되어 있지 않습니다. 에이전트는 다른 웹페이지를 다룰 때와 마찬가지로 스크린샷, DOM, 접근성 트리를 읽고, 브라우저 도구로 클릭하고 입력하면서 조작합니다.

Vercel 문서에는 프로젝트 설정 작업에서 이 차이를 비교한 벤치마크가 있습니다. Vercel의 수치에 따르면 Claude Code에서 Sonnet을 사용해 세 번 실행한 결과의 중앙값을 비교했을 때, 에이전트 브리지를 쓰면 도구 호출은 16회에서 5회로, 비용은 0.073달러에서 0.032달러로 줄었습니다. 제가 측정한 것이 아니라 Vercel이 한 가지 작업에서 얻은 수치지만, 방향은 납득이 갑니다. 페이지를 읽는 것보다 컴포넌트와 상태 목록을 읽는 편이 비용이 적게 듭니다. 권한과 커스텀 컴포넌트까지 포함해 브리지가 실제로 작동하는 데모를 AI 에이전트가 React 앱을 조작할 수 있게 만들기에서 구현했습니다.

에이전트가 UI를 사용하는 기능이 로드맵에 없다면, 이 항목을 선택의 결정적 근거로 삼을 필요는 없습니다. 반대로 로드맵에 있다면, 이 비교의 다른 선택지 중에는 근접한 대안조차 없습니다.

성숙도와 라이선스

Radix와 Base UI는 안정된 1.x 라이브러리입니다. API는 시맨틱 버저닝에 따라 변경되며, shadcn/ui는 모든 컴포넌트를 두 라이브러리용으로 모두 제공합니다.

UI SDK는 README와 문서에서 베타 상태이며 정식 출시 전까지 프레임워크, API, 문서, 동작이 바뀔 수 있다고 밝힙니다. 베타에는 Vercel의 공개 베타 약관이 적용됩니다. 여기에 더해 커스텀 프리미티브의 agent 키, 이력 및 실행 취소 헬퍼 등 일부 API는 실험적 기능으로 표시되어 있습니다. GitHub 저장소 vercel-labs/ui는 2026년 10월에 만들어졌으며, 변경 기록에는 2026년 11월 12일의 “UI SDK 소개” 항목만 있습니다.

라이선스도 다릅니다. Radix와 Base UI는 MIT입니다. UI SDK는 Apache-2.0으로, 이 역시 허용 범위가 넓은 라이선스이며 명시적인 특허 사용 허락도 포함합니다. Apache-2.0은 재배포 시 라이선스와 고지 사항을 유지하도록 요구하므로, 이 부분이 중요하다면 회사에서 라이선스를 담당하는 분에게 확인해 보세요.

프레임워크

Radix와 Base UI는 React 라이브러리입니다. UI SDK는 하나의 코어를 기반으로 @ui-sdk/react, @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid, @ui-sdk/web을 같은 버전으로 배포합니다. 회사에서 React 앱과 Vue 앱을 함께 운영하거나 CMS용 Web Components 빌드가 필요하다면, 세 라이브러리 중 같은 동작과 속성 이름으로 모두 지원할 수 있는 것은 UI SDK뿐입니다.

UI SDK의 React 패키지는 React 19와 React DOM 19 이상, @types/react 19.2.10 이상을 요구합니다. 아직 React 18을 사용한다면 당장은 이 조건만으로도 선택이 정해집니다.

각각 언제 선택하면 좋을까요

Radix를 계속 사용하세요. 앱이 잘 작동하고 팀이 익숙하며 막히는 부분이 없다면 그대로 쓰시면 됩니다. 이 비교에서 굳이 이전을 강요할 만한 이유는 없습니다. 이전하더라도 먼저 Base UI로 옮기세요. 변화의 폭이 더 작고, 그 과정에서 익힌 속성 모델을 UI SDK에서도 활용할 수 있습니다.

Base UI로 시작하세요. 지금 출시할 React 컴포넌트 라이브러리나 제품 UI를 만든다면 적합합니다. 안정 버전이고, shadcn/ui의 기본 선택지이며, 팝업과 폼, 애니메이션 패턴이 문서에 잘 정리되어 있습니다.

UI SDK로 시작하세요. 다음 중 하나에 해당한다면 적합합니다.

  • 여러 프레임워크에서 하나의 컴포넌트 모델을 공유해야 합니다.
  • UI SDK에만 있는 추가 컴포넌트가 필요하며, 이를 쓰지 않으면 날짜, 색상, 트리용 라이브러리를 따로 추가해야 합니다.
  • 에이전트가 UI를 조작하는 것이 제품의 목표이고, 권한과 변경 출처를 기본 기능으로 제공받고 싶습니다.
  • 프로토타입을 만들고 있으며, 베타 기간에 하위 호환성을 깨는 변경이 생겨도 감당할 수 있습니다.

섞어 쓰는 것도 가능합니다. UI SDK 컴포넌트에는 프로바이더가 필요하지 않으므로, Base UI 앱의 한 화면에서 UI SDK Color Picker를 사용할 수 있습니다. 다만 의존성 두 개와 서로 다른 속성 이름 체계를 함께 관리해야 하므로, 다른 곳에서는 구할 수 없는 컴포넌트에 한정해 사용하세요.

HextaUI의 선택

HextaUI의 컴포넌트는 계속 Base UI를 기반으로 합니다. 현재 사이트에 있는 것도 이 버전이며, 앞으로도 유지합니다. 에이전트 브리지나 추가 컴포넌트가 필요한 프로젝트를 위해, 같은 외형과 테마 토큰을 사용하는 별도의 UI SDK 버전도 만들고 있습니다. 아직 출시하지는 않았습니다. 출시되면 이전 작업을 하는 대신 사용할 버전을 선택하시면 됩니다.

Edit this page

Search the archive

Find a page by title, or search the text inside one.