Beschreibung
shadcn/ui unterscheidet sich von klassischen Komponentenbibliotheken durch sein Verteilungsmodell: Es definiert ein Schema für Komponenten und verteilt sie über eine eigene Kommandozeile, statt sie als fertiges Paket über die npm-Registry auszuliefern. Beim Hinzufügen einer Komponente kopiert die Kommandozeile den tatsächlichen Quellcode direkt in das eigene Projekt, standardmäßig nach components/ui/, ein einmaliger Init-Lauf legt zuvor die Konfigurationsdatei components.json, die passenden Tailwind-Einstellungen und einen kleinen Utility-Helfer an. Ursprünglich, seit dem Start im Januar 2023, baute das Projekt auf Radix als Unterbau für barrierefreie, unstyled Primitive auf; seit Juli 2026 ist Base UI, ein Nachfolgeprojekt derselben Entwicklerinnen und Entwickler, der neue Standardunterbau, während Radix vollständig unterstützt bleibt und bestehende Projekte auf ihrer bisherigen Basis verbleiben.
Unterstützt werden React ab Version 18 sowie React 19, eingebunden über Next.js, Vite, Laravel, React Router, Astro oder TanStack Start, dazu Tailwind CSS in Version 3 oder 4 und TypeScript als Standard. Weil der Komponenten-Code Teil des eigenen Projekts wird, gibt es kein automatisches Paket-Update wie bei einer klassischen Bibliothek: Eigene Anpassungen bleiben erhalten, ein Rücksetzen auf die Ursprungsversion erfordert das gezielte, erneute Ausführen des Installationsbefehls mit einer Overwrite-Option. Über eine Registry-Verzeichnisübersicht lassen sich zusätzliche, von Drittanbietern gepflegte Registries mit weiteren Komponenten und Blöcken einbinden, ohne zusätzliche Konfiguration der Kommandozeile, allerdings mit eigener Prüfpflicht für deren Code.
Gegenüber stark gestalteten Komponentenbibliotheken für Marketingseiten ist shadcn/ui bewusst zurückhaltend: Es liefert funktionale, barrierefreie Basisbausteine wie Formulare, Dialoge oder Tabellen statt auffälliger, animationslastiger Hero-Sektionen. shadcn/ui ist als Grundlage für ein eigenes Design-System angelegt; über die Registry-Verzeichnisübersicht lassen sich darauf aufbauende Komponentensammlungen für Marketing- oder Motion-lastige Oberflächen ergänzen.
