shadcn/ui yenilikler: shadcn create, CLI 3.0, Tailwind v4 ve sürüm geçmişi

Zaman çizelgesi bir bakışta

Aralık 2025: npx shadcn create

Duyuru metni ilginç bir öz eleştiriyle başlar: shadcn/ui'nin amacı baştan beri özelleştirilebilir olmaktı, ama varsayılanlar o kadar iyi bulundu ki birçok uygulama birbirine benzemeye başladı. npx shadcn create buna yanıt olarak bileşen kütüphanesini, simgeleri, temel rengi, temayı ve yazı tiplerini seçmenizi sağlar. Başlangıçta beş görsel stil sunulur:

Duyuru bunun tema değiştirmenin ötesine geçtiğini vurgular: yaptığınız yapılandırma yalnızca renkleri değiştirmez, bileşen kodunu da kurulumunuza uyacak biçimde yeniden yazar; yazı tipi, boşluk, yapı ve kullanılan kütüphaneler tercihinize uyar. Bileşen kütüphanesi olarak Radix veya Base UI seçilir. Her bileşen Base UI için aynı soyutlamayla yeniden yazıldı ve uzak registry'lerden gelenler dahil mevcut bileşenlerle uyumlu olduğu belirtilir; bileşen çektiğinizde CLI kütüphanenizi algılayıp gerekli dönüşümleri uygular. Duyuru tarihinde Next.js, Vite, TanStack Start ve v0 için kullanılabilir olduğu yazılır.

Pratik bir not: CLI 3.6.2 kaynak kodunda adı base- veya radix- ile başlayan stillerde sidebar, login, signup, otp ve calendar bloklarının henüz kurulamadığını bildiren bir uyarı vardır. Ayrıntı Blocks yazısında.

Kasım, Ekim ve Eylül 2025

Kasım 2025'te Registry Directory yayımlandı: kod ve bileşen çekebileceğiniz registry'lerin listesi. Duyuruya göre CLI'ye gömülüdür ve yapılandırma istemez. Bundan bir ay önce, Eylül 2025'te açık kaynak registry dizini (registry index) gelmişti. Bu dizindeki registry'lerden öğeleri components.json dosyasını önceden yapılandırmadan arayabilir, görüntüleyebilir ve ekleyebilirsiniz; CLI ilgili registry'yi dosyanıza kendisi ekler. Örnek: npx shadcn add @ai-elements/prompt-input. Ayrıntılar namespace yazısında.

Ekim 2025'te her gün yeniden yazılan sıkıcı parçalar için yeni bileşenler geldi. Duyuruya göre bunlar Radix, Base UI, React Aria gibi her bileşen kütüphanesiyle çalışır:

• Spinner: yükleniyor durumunu gösteren gösterge.
• Kbd: bir klavye tuşunu ya da tuş grubunu gösterir.
• Button Group: eylemler ve bölünmüş butonlar için buton grubu.
• Input Group: simge, buton, etiket ve daha fazlasıyla birleşen girdi.
• Field: duyurudaki ifadeyle tüm formlar için tek bileşen.
• Item: öğe listeleri ve kartlar.
• Empty: boş durum ekranları.

Duyuru metni yedi bileşen listeler ve sonunda da "yedi yeni bileşen" der.

Ağustos 2025: shadcn CLI 3.0 ve MCP sunucusu

CLI 3.0, registry tarafının büyük yeniden yazımıdır. En büyük değişiklik namespace'li registry'lerdir: @registry/name biçimiyle topluluk registry'lerinden, şirketinizin özel registry'sinden veya iç registry'lerden bileşen kurabilirsiniz. Sistem merkezi değildir; istediğiniz namespace'i oluşturursunuz. Bileşenler farklı registry'lerdeki kaynaklara bağımlı olabilir. Özel registry'ler için token, API anahtarı ve özel başlıklarla kimlik doğrulama geldi; duyuru basic auth, bearer token, sorgu parametresiyle API anahtarı ve özel başlıkları sayar.

Kurmadan önce keşif için üç komut eklendi: kurulumdan önce öğeyi görmek için view, registry'lerde arama için search ve bir registry'nin tüm öğelerini listelemek için list. Duyurudaki örnekler:

npx shadcn view @acme/auth-system
npx shadcn search @tweakcn -q "dark"
npx shadcn list @acme

MCP sunucusu da yeniden yazıldı: tüm registry'lerle yapılandırmasız çalışma, popüler istemcilere tek komutla ekleme (npx shadcn@latest mcp init), iyileştirilmiş araçlar ve aynı projede birden çok registry. Kurulumu MCP sunucusu yazısında. Registry çözümleme motoru sıfırdan yazıldı; duyuru bağımlılık çözümlemesinin 3 kata kadar hızlandığını, dosya tekilleştirme ve birleştirmenin akıllandığını, monorepo desteğinin iyileştiğini ve registry yazarları için build komutunun güncellendiğini söyler. Hata mesajları da kullanıcılara ve dil modellerine yol gösterecek biçimde yenilendi; registry yazarları yanıtlarında özel mesajlar döndürebilir. Bu mesajların listesi sık hatalar yazısında.

Yükseltme rehberine göre kullanıcılar için kırıcı değişiklik yoktur: mevcut components.json ve kurulu bileşenler aynen çalışır. Programatik API kullanan geliştiriciler için fetchRegistry yerine getRegistry, resolveRegistryTree yerine resolveRegistryItems önerilir ve şema shadcn/registry yerine shadcn/schema paketinden alınır:

// Eski
import { registryItemSchema } from "shadcn/registry"
// Yeni (CLI 3.0)
import { registryItemSchema } from "shadcn/schema"

Temmuz ve Haziran 2025

Temmuz 2025'te evrensel registry öğeleri geldi: framework, components.json, Tailwind veya React gerektirmeden herhangi bir projeye kod, yapılandırma, kural ve belge dağıtabilen öğeler. Aynı ay CLI yerel dosya desteği kazandı; projeyi yerel bir JSON şablonundan başlatabilir, bileşeni yerel bir dosyadan ekleyebilirsiniz. Duyuru bunu uzak registry gerektirmeyen, yayımlamadan önce yerelde deneme yapılabilen bir akış olarak anlatır:

npx shadcn init ./template.json
npx shadcn add ./block.json

Haziran 2025'te tek radix-ui paketine geçiş için bir komut eklendi. npx shadcn@latest migrate radix komutu ui bileşenlerinizdeki tüm @radix-ui/react-* içe aktarmalarını radix-ui ile değiştirir ve paketi bağımlılık olarak kurar:

// Önce
import * as AlertDialogPrimitive from "@radix-ui/react-dialog"
// Sonra
import { AlertDialog as AlertDialogPrimitive } from "radix-ui"

Duyuru, komuttan sonra bileşenlerinizi ve projenizi test etmenizi ve sonradan eklediğiniz bileşenler için komutu yeniden çalıştırmanız gerektiğini not eder. Aynı ay Calendar bileşeni React DayPicker'ın son sürümüne taşındı ve 30'dan fazla takvim bloğu yayımlandı; yükseltme adımları Calendar yazısında.

Mayıs, Nisan ve Mart 2025

Mayıs 2025'te ui.shadcn.com sitesi Next.js 15.3 ve Tailwind v4'e taşındı ve güncellenmiş new-york bileşenlerini kullanmaya başladı. Nisan 2025'te registry'ler için sıfır yapılandırmalı MCP desteği üzerinde çalışıldığı duyuruldu; bu çalışma Ağustos'taki CLI 3.0 ile olgunlaştı. Mart 2025'te shadcn 2.5.0 etiketlendi ve "her yere çözümleme" (resolve anywhere) geldi: registry'ler dosyaları uygulamanın herhangi bir yerine, hatta registry dışındaki konumlara yerleştirebilir; kurulumda tüm dosyalar izlenir ve içe aktarmalar ile takma adlar birkaç geçişte çözülür. Yine Mart 2025'te CLI çatıyı otomatik algılayıp rotaları buna göre uyarlamaya başladı; duyuruda Laravel, Vite ve React Router anılır.

Şubat ve Ocak 2025: Tailwind v4 dönemi

Şubat 2025, bugünkü shadcn/ui'yi en çok şekillendiren aydır. Tailwind v4 ve React 19 için ilk önizleme yayımlandı. Değişiklik listesi şunları içerir: CLI projeleri Tailwind v4 ile başlatabilir; @theme yönergesi ve @theme inline seçeneği tam desteklenir; tüm bileşenler Tailwind v4 ve React 19 için güncellendi; forwardRef kullanımları kaldırılıp türler ayarlandı; her temel parçaya stil için data-slot özniteliği eklendi; butonlar varsayılan imleci kullanır; HSL renkler OKLCH'ye dönüştürüldü. İki kullanımdan kaldırma da bu aya aittir: toast bileşeni sonner lehine, default stili ise new-york lehine. Tailwind v4 belgesi bunun kırıcı olmadığını, mevcut Tailwind v3 ve React 18 projelerinin çalışmaya devam ettiğini belirtir.

Tailwind v4 belgesinin kendi değişiklik notlarına göre 12 Mart 2025'te karanlık mod renkleri erişilebilirlik için yeniden düzenlendi, 19 Mart 2025'te ise tailwindcss-animate paketi tw-animate-css lehine kullanımdan kaldırıldı. Yükseltme adımları Tailwind v4 geçişi yazısında, toast yerine Sonner kullanımı Sonner yazısında anlatılıyor.

Yine Şubat 2025'te registry şeması genişletildi: kendi tasarım sisteminizi, bileşenlerinizi ve token'larınızı getiren özel stiller; üçüncü taraf registry'lerden ve dil modellerinden gelen bileşenleri genişletme, ezme ve karıştırma; tema, CSS değişkeni, hook, animasyon ve Tailwind katman ile utility kurulumu. Ocak 2025'te ise topluluk blok kütüphanesine katkıya davet edildi.

2024: yeni CLI, monorepo, sidebar ve bloklar

Ağustos 2024'te tamamen yeniden yazılmış CLI çıktı; artık npx shadcn add ile bileşenlerin yanında tema, hook ve yardımcı dosyalar da kurulabiliyordu. Duyurudaki maddeler: Next.js, Remix, Vite ve Laravel için kutudan çıktığı gibi destek; yeni bir uygulamada init yapıldığında mevcut Tailwind dosyalarının üzerine yazmak yerine güncellenmesi; bileşenlerin kendi bağımlılıklarını taşıması; npx shadcn add https://acme.com/registry/navbar.json gibi URL ile uzak bileşen kurulumu; framework algılayan ve tek komutla yeni bir Next.js uygulaması da başlatabilen init; kendi registry'nizi dağıtmanız için yeni şema. Mevcut projeler için components.json dosyasına beş takma ad eklenmesi istendi:

{
  "$schema": "https://ui.shadcn.com/schema.json",
  "style": "new-york",
  "tailwind": {},
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "ui": "@/components/ui",
    "lib": "@/lib",
    "hooks": "@/hooks"
  }
}

Ekim 2024'te shadcn/ui React 19 ve Next.js 15 ile uyumlu hale geldi ve bir yükseltme rehberi yayımlandı (bkz. React 19 peer dependency yazısı). Aynı ay sidebar.tsx geldi; duyuru bunu her türlü kenar çubuğu için 25 bileşen olarak tanımlar. Kasım 2024'te new-york stilinin varsayılan simge seti Lucide oldu; mevcut projeler için kırıcı değişiklik yoktu. Aralık 2024'te CLI monorepo yapısını anlamaya başladı ve bileşenleri, bağımlılıkları ve registry bağımlılıklarını doğru yollara kurup içe aktarmaları düzeltir oldu. Mart 2024'te Blocks ile birlikte Breadcrumb ve Input OTP, Nisan 2024'te Lift Mode yayımlandı.

2023: temeller

Haziran 2023'te CLI baştan yazıldı ve bugün hâlâ kullandığımız kavramların çoğu o zaman geldi: soruları yanıtlayarak oluşturulan components.json, CSS değişkenleri ile Tailwind utility sınıfları arasında tema seçimi, temel renk (base color), React Server Components için use client yönergesini ekleyip kaldırma, kendi bileşen, animasyon ve simge setiyle gelen stil kavramı ve tüm bileşenlere çıkış animasyonları. Aynı duyuruda deneysel bir diff komutu da tanıtılmıştı; ancak güncel CLI belgesinde bu komut anlatılmaz, bu yüzden onu bugünkü bir komut olarak düşünmeyin. Temmuz 2023'te bileşenlerin JavaScript sürümü geldi ve TypeScript kullanmak istemeyenler için components.json içindeki tsx: false ayarı tanıtıldı. Aralık 2023'te Carousel, Drawer, Pagination, Resizable ve Sonner bileşenleri ile özel Tailwind öneki desteği yayımlandı.

Projenizi güncel tutmak

shadcn/ui bileşenleri projenize kopyalandığı için bir paketi güncellemek gibi tek komutluk bir yükseltme yoktur. Tailwind v4 belgesi bunu bir avantaj olarak sunar: elinizdeki kod kendi yazacağınız kodun aynısıdır, bağımlılıklar yeni sürüm çıkardığında onların resmi yükseltme yollarını izlersiniz. Bileşenleri güncel sürümleriyle yeniden almak için belgenin önerdiği yol, önce değişikliklerinizi commit etmek, sonra tüm bileşenleri yeniden eklemek ve son olarak kendi değişikliklerinizi gözden geçirip yeniden uygulamaktır:

git add .
git commit -m "bileşenler güncellenmeden önce"
npx shadcn@latest add --all --overwrite

Sık yapılan hatalar

• Eski rehberlerdeki komutları kullanmak: Güncel CLI belgesi init, add, view, search, list ve build komutlarını anlatır. Eski bir yazıda geçen diff bu listede yoktur.
• Kullanımdan kalkan parçaları yeni projede kurmak: toast yerine sonner, tailwindcss-animate yerine tw-animate-css, default stil yerine new-york kullanın.
• migrate radix sonrası yeni bileşenleri unutmak: Komut yalnızca o an var olan bileşenleri dönüştürür; sonradan eklediklerinize yeniden çalıştırın.
• React 19 rehberini güncel sanmak: React 19 sayfasının başında rehberin eskimiş olabileceğine dair bir uyarı vardır; tam destek latest sürümde gelmiştir.

Sık Sorulan Sorular

Yeni stillerden birine geçmek için projemi baştan mı kurmalıyım?

Değişiklik günlüğü create akışını yeni projeler üzerinden anlatır. components.json belgesi de style değerinin kurulumdan sonra değiştirilemeyeceğini söyler. Mevcut bir projeyi yeni bir stile taşımanın resmi bir yolu depo kopyasında anlatılmaz.

CLI 3.0 mevcut projemi bozar mı?

Yükseltme rehberine göre hayır: components.json ve kurulu bileşenler aynen çalışır. Değişiklik yalnızca CLI'nin programatik API'sini doğrudan kullananları etkiler.

Hangi sürümde olduğumu nasıl anlarım?

Bileşen kodu projenizde durduğu için sürüm bilgisi bileşenlerde değil, kullandığınız CLI paketindedir. Bu yazının dayandığı depo kopyasında shadcn paketinin sürümü 3.6.2'dir.

Base UI seçersem eski registry bileşenleri çalışır mı?

Duyuruya göre Base UI için yeniden yazılan bileşenler mevcut bileşenlerle, uzak registry'lerden gelenler dahil, uyumludur ve CLI kütüphanenizi algılayıp doğru dönüşümleri uygular. Base UI'nin iç ayrıntıları bu yazının kapsamı dışındadır.

Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: shadcn/ui öğrenme rehberi · Tailwind v4 geçişi · shadcn MCP sunucusu · Namespace ve özel registry · shadcn/ui nedir