Vercel UI SDK, Vercel Labs'ın 12 Kasım 2026'da duyurduğu açık kaynak bir kütüphanedir. Bileşen değil, davranış verir: klavye gezinmesi, odak yönetimi, seçim, açılır pencerenin kapanması, sürükle-bırak ve bunların gerektirdiği ARIA öznitelikleri. Bu parçaları bir geliştirici ya da bir yapay zekâ ajanı birleştirip kendi bileşenini kurar. Kütüphane Apache 2.0 lisanslıdır ve henüz beta aşamasındadır.
Kısacası: UI SDK, bileşenlerin "çalışan kısmını" hazır verir. Görünümü sizin tasarım sisteminiz belirler.
Ne işe yarar?
Menü, diyalog ve sekme gibi kalıpların hazır bileşenleri zaten var. Zor olan, ürünüze özel bir etkileşim yazmaktır: bir kanban panosu, kaydırılabilen bir zaman çizelgesi ya da tek bir iş için yapılmış bir seçici. Bu tür bileşenlerde asıl iş görünüm değil davranıştır. Odak, içindeki öğe silinince nereye gitmeli? Escape hangi katmanı kapatmalı? Kapanan bir açılır pencere kullanıcıyı nereye döndürmeli?
UI SDK dokümanı bu soruların her birine hazır bir parça koyar. Duyuruda ve dokümanda örnek verilen parçalar şunlardır:
createRovingFocus: ok tuşlarıyla öğeler arasında gezinme (Tab bir kez girer, bir kez çıkar).createTypeahead: yazarken seçenek bulma.createPopup: düğmenin yanında açılan, Escape ve dış tıklamada kapanan pencere.
Kütüphane, bu parçalardan 50'den fazla bileşen davranışı içerdiğini söyler. Kendi react paketinde de ayrıca stilsiz bileşen seti bulunur.
Kime yarar?
- Frontend geliştiricileri, etkileşimi sıfırdan yazmak yerine hazır parçalardan kurmak isteyenler.
- Ürün ekipleri, standart bir kütüphanede karşılığı olmayan bir arayüz geliştirenler.
- Ajanla kod yazan ekipler. Dokümana göre kütüphane, ajanın doğru parçaları seçmesi için bir skill ve
llms.txtdosyası sunar (npx skills add vercel-labs/ui --skill ui-sdk).
Kod: davranışı tanımla, sonra render et
UI SDK'da iki adım vardır. Önce bir primitive tanımlanır: durum, durumu değiştiren fonksiyonlar ve parçalar. Sonra bir adaptör, bu primitive'i kullandığınız framework'te çizer. Dokümandaki basit bir açma-kapama düğmesi örneği şöyle:
import { definePrimitive } from "@ui-sdk/core"
const muteButton = definePrimitive({
name: "mute-button",
state: () => ({ muted: false }),
api: (context) => ({
toggle: () => context.store.set({ muted: !context.store.get().muted }),
}),
slots: (slot) => ({
root: slot({
attrs: (state) => ({
type: "button",
"aria-pressed": String(state.muted),
}),
press: ({ api }) => api.toggle(),
}),
}),
})
export { muteButton }
React'te bu primitive şöyle çizilir:
import { createParts } from "@ui-sdk/react/primitive"
import { muteButton } from "@/lib/mute-button"
const { Root: MuteButton } = createParts(muteButton, { root: "button" })
function Example() {
return <MuteButton>Mute</MuteButton>
}
Dokümanın hazır Toggle bileşeni ise tek satırdır. Basılı durumu data-pressed özniteliğiyle verir ve aria-pressed ile ekran okuyucuya bildirir:
import { Toggle } from "@ui-sdk/react/toggle"
function BookmarkButton() {
return <Toggle className="rounded-md border px-3 data-pressed:bg-neutral-900 data-pressed:text-white">Bookmark</Toggle>
}
Parçalar stilsizdir. Görünümü CSS ya da Tailwind ile siz verirsiniz. Aynı primitive Vue, Svelte, Solid ve Web Components için de çizilebilir.
AI SDK ile ilişkisi
Bu konuda en çok karışıklık oluyor. Üç ayrı ürün var:
| Ürün | Ne yapar | İlişkisi |
|---|---|---|
Vercel AI SDK (ai, @ai-sdk/react) |
Model sağlayıcılarını, akışı (streaming), araç çağrılarını ve useChat gibi kancaları verir. |
Yapay zekâ özelliklerinin çalışma katmanıdır. |
| AI Elements | AI SDK için shadcn/ui üzerine kurulu sohbet bileşenleridir. | AI SDK'nın görsel tarafıdır. Proje sayfası shadcn/ui'a taşındığını ve bu projenin kasım 2026 sonunda kullanımdan kalkacağını yazıyor. |
| UI SDK | Klavye, odak ve ARIA davranışlarını parça olarak verir. | AI SDK'dan bağımsızdır. Yapay zekâ tarafı ise ajanın bileşeni okuyup eylem yapabilmesi için ayrı bir köprüdür. |
Yani UI SDK, AI SDK'nın UI katmanı değildir ve AI Elements'in yerine geçen bir sohbet kütüphanesi de değildir. Dokümandaki ajan örneği ise AI SDK ile birlikte çalışır: sunucuda useChat ve ai paketinden lastAssistantMessageIsCompleteWithToolCalls kullanılır. Bu birlikte kullanım bir tercihtir, zorunluluk değildir.
Base UI, Radix ya da shadcn/ui kullanıyorsak?
Dürüst cevap: çoğu projede bu kütüphaneler yeterlidir ve UI SDK'ya geçmek için sebep yoktur.
- Standart kalıplar (menü, diyalog, sekme, seçim kutusu) için mevcut kütüphaneniz olgun ve tanıdıktır. Bunları UI SDK ile yeniden yazmak kazanç getirmez.
- Özel etkileşimler için UI SDK'nın değeri ortaya çıkar: bir kütüphanede hazır olmayan bir şeyi, davranışı yeniden icat etmeden kurmak. UI SDK'nın kendi dokümanı da bu gerekçeyi verir: kütüphaneler tanıdık kalıpları kapsar, ürününüzün ihtiyacı ise bunların dışında kalabilir.
- Birlikte kullanım: UI SDK dokümanları, yazının yazıldığı tarihte, mevcut kütüphanelerle birlikte nasıl kullanılacağını anlatan bir bölüm içermiyor. Denemeden "birlikte çalışır" demek doğru olmaz. Dokümanın teşekkür bölümü Radix, Base UI, React Aria, shadcn/ui ve Nuxt UI'den ilham alındığını söylüyor, ama bu bir entegrasyon garantisi değildir.
- Gereksiz olduğu durum: basit bir açılır menü ya da sekme için UI SDK eklemek, beta bir bağımlılığı üretime sokmak demektir.
Sınırlamalar ve olgunluk
- Beta. README "UI SDK is in beta" diyor ve Vercel'in beta şartlarına tabi olduğunu belirtiyor. Aynı metin, framework'ün, API'lerin, dokümanın ve davranışın genel kullanıma çıkmadan önce değişebileceğini söylüyor.
- Sürüm. npm'de
@ui-sdk/coreve adaptörleri0.1.0-beta.13sürümünde vebetaetiketiyle yayınlanıyor. GitHub'da son sürüm yayınları 19 Kasım 2026 tarihli. - Çalışma ortamı.
@ui-sdk/reactpaketi React 19 ve üzeri ister. - Değişiklik geçmişi kısa. Dokümandaki changelog'da şu an tek giriş, 12 Kasım 2026 tarihli duyuru var.
- Astro. Resmî adaptör listesinde Astro yok. Web Components adaptörü (
@ui-sdk/web) ile denenebilir, ama bunu denemedik. - Performans iddiaları. Haber sitelerinde Vercel'in ajan verimliliğiyle ilgili rakamlar geçiyor. Bu rakamları resmî kaynakta bulamadığımız için yazıya almadık.
Besh perspektifi
Bizim yorumumuz: Besh'in sitelerinde temel çatı Astro. UI SDK'nın resmî adaptörleri React, Vue, Svelte, Solid ve Web Components olduğu için bu kütüphaneyi bugün bir Besh sitesine doğrudan koymak için önce ayrı bir deneme gerekir. Ajanla bileşen üretirken ise davranış parçalarının hazır olması, sıfırdan erişilebilirlik yazmaktan daha güvenli bir başlangıç olabilir. Bu bir öneridir, ölçüm değildir.
Özel bir etkileşim gerektiren bir ürün projeniz varsa, web yazılımı ve özel yazılım geliştirme hizmetlerimiz hakkında konuşabiliriz.
Sıkça Sorulan Sorular
Vercel UI SDK, Vercel AI SDK'nın bir parçası mı?
Hayır. UI SDK, vercel-labs organizasyonundaki ayrı bir açık kaynak projedir. AI SDK ise ai-sdk.dev adresinde yapay zekâ uygulamaları için ayrı bir TypeScript araç setidir. İkisi birlikte kullanılabilir, ama biri diğerinin zorunlu bileşeni değildir.
shadcn/ui'ın yerine geçer mi?
Hayır, farklı bir katmanda çalışır. shadcn/ui stillenmiş bileşenleri kopyalanabilir biçimde sunar. UI SDK ise stilsiz davranış parçaları verir. Görünümü shadcn/ui ile kurup davranış için UI SDK kullanmak teknik olarak mümkündür, ama bu birlikte kullanım resmî dokümanda ayrıca tarif edilmiyor.
Üretimde kullanabilir miyim?
Beta olduğu için API'ler ve davranış genel kullanıma çıkmadan değişebilir. Üretimde kullanacaksanız sürümü sabitleyin ve her yükseltmede değişiklik notlarını okuyun.
Hangi framework'leri destekliyor?
React, Vue, Svelte, Solid ve Web Components. Her biri için ayrı bir adaptör paketi var (@ui-sdk/react, @ui-sdk/vue, @ui-sdk/svelte, @ui-sdk/solid, @ui-sdk/web). Adaptörlerin peer bağımlılıkları sürüme göre değişir, kurmadan önce kendi paketinizle uyumunu kontrol edin.
Kaynaklar: vercel-labs/ui GitHub deposu (README, paket dosyaları, dokümantasyon), UI SDK dokümantasyonu, UI SDK duyuru notu, 12 Kasım 2026, Vercel'in duyuru gönderisi, 12 Kasım 2026, Vercel AI SDK dokümantasyonu, AI Elements proje sayfası, Vercel AI Elements duyurusu, npm: @ui-sdk/core
Kapak fotoğrafı: Christopher Gower / Unsplash