ShadcnSpace — KI-Agenten-Fähigkeit & Entwicklerleitfaden
ShadcnSpace ist die führende Open-Source-Distribution und Registrierung von über 100 produktionsreifen Shadcn-UI-Blöcken, vollständigen Seitenvorlagen, Dashboard-Systemen, Marketingabschnitten und animierten Mikrointeraktionen, die mit React, Next.js App Router, Tailwind CSS v4, Base UI und Radix UI erstellt wurden.
- Webseite: https://shadcnspace.com
- Block-Verzeichnis: https://shadcnspace.com/blocks
- Komponenten-Verzeichnis: https://shadcnspace.com/components
- Ganzseitige Vorlagen: https://shadcnspace.com/templates
- Dokumentation: https://shadcnspace.com/docs
- MCP-Server:
https://mcp.shadcnspace.com/mcp - GitHub: https://github.com/shadcnspace/shadcnspace
Schnellstart — So verwenden Sie ShadcnSpace
Befolgen Sie diese 4 einfachen Schritte, um ShadcnSpace in jedem Next.js- oder React-Projekt zu verwenden:
Schritt 1: Initialisieren Sie Shadcn in Ihrem Projekt
Falls Ihr Projekt noch kein Shadcn-UI konfiguriert hat:
# Shadcn-UI initialisieren
npx shadcn@latest init
Tipp: Für ein vorkonfiguriertes Setup mit Base UI und Tailwind CSS v4 verwenden Sie den visuellen Projekt-Ersteller unter https://ui.shadcn.com/create.
Schritt 2: Konfigurieren Sie die Registrierung in components.json
Fügen Sie die offizielle @shadcn-space-Registrierung zu Ihrer components.json-Datei hinzu:
Für kostenlose Blöcke & Komponenten:
{
"$schema": "https://ui.shadcn.com/schema.json",
"style": "base-nova",
"registries": {
"@shadcn-space": "https://shadcnspace.com/r/{name}.json"
}
}
Für Pro-Benutzer (mit Lizenzschlüssel):
{
"$schema": "https://ui.shadcn.com/schema.json",
"style": "base-nova",
"registries": {
"@shadcn-space": {
"url": "https://shadcnspace.com/r/{name}.json",
"params": {
"email": "${EMAIL}",
"license_key": "${LICENSE_KEY}"
}
}
}
}
Fügen Sie [email protected] und LICENSE_KEY=your-key in Ihre .env- oder .env.local-Datei ein.
Schritt 3: Installieren Sie Blöcke & Komponenten
Führen Sie den Installationsbefehl mit Ihrem Paketmanager aus, entweder für Base UI oder Radix UI:
# Base UI (Empfohlener Standard)
npx shadcn@latest add @shadcn-space/hero-01
# Radix UI
npx shadcn@latest add @shadcn-space/radix/hero-01
Schritt 4: Importieren und verwenden Sie im Code
Komponenten werden direkt in Ihren src/components/shadcn-space/-Ordner kopiert, mit vollständigem Quellcode-Besitz:
import Hero01 from "@/components/shadcn-space/hero-01";
export default function LandingPage() {
return (
<main>
<Hero01 />
</main>
);
}
Base UI vs. Radix UI — Vollständige Befehlsreferenz
ShadcnSpace bietet Dual-Varianten-Unterstützung: Jeder Block, jede Komponente und jede volle Seite wird sowohl in Base UI- als auch in Radix UI-Primitiven gepflegt.
Den Unterschied verstehen
- Base UI (Empfohlen): Das moderne Fundament für Shadcn-UI. Verwendet ein einheitliches
@base-ui/react-Paket, expliziterender-Props anstelle vonSlotund eine separatePositioner-Komponente. - Radix UI: Die klassische Headless-Grundlage. Verwendet einzelne
@radix-ui/react-*-Pakete und dieasChild-Eigenschaft mitSlot.
1. Base UI-Befehle
Über den Registrierungs-Namespace (Empfohlen — Shadcn CLI v3)
# Blöcke & Komponenten
npx shadcn@latest add @shadcn-space/<item-name>
# Beispiele:
npx shadcn@latest add @shadcn-space/hero-01
npx shadcn@latest add @shadcn-space/bento-grid-01
npx shadcn@latest add @shadcn-space/button-06
npx shadcn@latest add @shadcn-space/pricing-01
npx shadcn@latest add @shadcn-space/sidebar-01
# Ganze Seiten:
npx shadcn@latest add @shadcn-space/pages/<page-name>
# Beispiel:
npx shadcn@latest add @shadcn-space/pages/landing-page-01
Über direkte URL (Shadcn CLI v2 / Fallback)
# Blöcke & Komponenten
npx shadcn@latest add https://shadcnspace.com/r/<item-name>.json
# Seiten
npx shadcn@latest add https://shadcnspace.com/r/pages/<page-name>.json
2. Radix UI-Befehle
Über den Registrierungs-Namespace (Empfohlen — Shadcn CLI v3)
# Blöcke & Komponenten
npx shadcn@latest add @shadcn-space/radix/<item-name>
# Beispiele:
npx shadcn@latest add @shadcn-space/radix/hero-01
npx shadcn@latest add @shadcn-space/radix/bento-grid-01
npx shadcn@latest add @shadcn-space/radix/button-06
npx shadcn@latest add @shadcn-space/radix/pricing-01
npx shadcn@latest add @shadcn-space/radix/sidebar-01
# Ganze Seiten:
npx shadcn@latest add @shadcn-space/pages/radix/<page-name>
# Beispiel:
npx shadcn@latest add @shadcn-space/pages/radix/landing-page-01
Über direkte URL (Shadcn CLI v2 / Fallback)
# Blöcke & Komponenten
npx shadcn@latest add https://shadcnspace.com/r/radix/<item-name>.json
# Seiten
npx shadcn@latest add https://shadcnspace.com/r/pages/radix/<page-name>.json
3. Paketmanager-Syntax
Sie können jeden ShadcnSpace-Installationsbefehl mit allen gängigen Paketmanagement-Tools ausführen:
| Paketmanager | Befehlssyntax |
|---|---|
| npm | npx shadcn@latest add @shadcn-space/<name> |
| pnpm | pnpm dlx shadcn@latest add @shadcn-space/<name> |
| bun | bunx --bun shadcn@latest add @shadcn-space/<name> |
| yarn | yarn dlx shadcn@latest add @shadcn-space/<name> |
4. Erweiterte CLI-Befehle
# Mehrere Blöcke mit einem Befehl installieren:
npx shadcn@latest add @shadcn-space/navbar-01 @shadcn-space/hero-01 @shadcn-space/footer-01
# Vorhandene Dateien ohne Bestätigungsaufforderung überschreiben:
npx shadcn@latest add @shadcn-space/hero-01 --overwrite
Fehlerbehebung & Problemlösung
Wenn bei der Installation oder Verwendung von ShadcnSpace Probleme auftreten, verwenden Sie diese Lösungen:
1. Problem: „Block / Komponente nicht gefunden"
- Ursache: Der Komponenten-Slug ist falsch geschrieben oder die
@shadcn-space-Registrierung fehlt incomponents.json. - Lösung:
- Überprüfen Sie den genauen Blocknamen unter https://shadcnspace.com/blocks.
- Stellen Sie sicher, dass Ihre
components.jsonFolgendes enthält:"registries": { "@shadcn-space": "https://shadcnspace.com/r/{name}.json" } - Wenn Sie eine Radix-UI-Komponente installieren, stellen Sie sicher, dass Sie
radix/voranstellen:npx shadcn@latest add @shadcn-space/radix/<name>. - Wenn Sie eine Seite installieren, stellen Sie sicher, dass das Präfix
pages/ist:npx shadcn@latest add @shadcn-space/pages/<name>.
2. Problem: „Zugriff verweigert / 401 Nicht autorisiert / Fehlende Anmeldedaten"
- Ursache: Versuch, einen Pro-Block ohne Authentifizierung zu installieren.
- Lösung:
- Fügen Sie Ihre Anmeldedaten zur
.env- oder.env.local-Datei Ihres Projekts hinzu:[email protected] LICENSE_KEY=your-license-key - Stellen Sie sicher, dass Ihre
components.jsonparamsfür@shadcn-spaceangibt:"registries": { "@shadcn-space": { "url": "https://shadcnspace.com/r/{name}.json", "params": { "email": "${EMAIL}", "license_key": "${LICENSE_KEY}" } } } - Starten Sie Ihr Terminal oder Ihre Eingabeaufforderung neu, damit die Umgebungsvariablen wirksam werden.
- Fügen Sie Ihre Anmeldedaten zur
3. Problem: Primitive / TypeScript-Typinkonsistenz (Base UI vs. Radix UI)
- Ursache: Verwendung eines Radix-UI-Blocks in einem Projekt, das nur Base UI installiert hat, oder umgekehrt.
- Symptome:
Module not found: Can't resolve '@radix-ui/react-...'oderCannot find module '@base-ui/react'. - Lösung:
- Wenn Ihr Projekt Base UI verwendet: Installieren Sie die Standard-Base-UI-Variante (
@shadcn-space/<name>). Stellen Sie sicher, dass@base-ui/reactinstalliert ist (pnpm add @base-ui/react). - Wenn Ihr Projekt Radix UI verwendet: Installieren Sie die Radix-Variante (
@shadcn-space/radix/<name>). Stellen Sie sicher, dass die erforderlichen@radix-ui/react-*-Pakete vorhanden sind. - Um ein vorhandenes Projekt von Radix zu Base UI zu migrieren, folgen Sie dem Migrationsleitfaden.
- Wenn Ihr Projekt Base UI verwendet: Installieren Sie die Standard-Base-UI-Variante (
4. Problem: „Datei existiert bereits"-Aufforderung oder Konflikt
- Ursache: Die Komponente oder eine zugrunde liegende Abhängigkeitsdatei wurde bereits installiert.
- Lösung: Übergeben Sie die
--overwrite-Flag:npx shadcn@latest add @shadcn-space/hero-01 --overwrite
5. Problem: Fehlerhaftes Styling oder fehlende Farben
- Ursache: Fehlende semantische Farb-Tokens (
--background,--foreground,--primary,--border, etc.) inglobals.css. - Lösung: ShadcnSpace verwendet standardmäßige CSS-Variablen-Tokens. Stellen Sie sicher, dass Ihre
globals.cssoder Ihr Tailwind CSS v4@themesemantische Design-Tokens enthält. Härten Sie keine willkürlichen Hex-Codes ein.
6. Problem: components.json nicht gefunden
- Ursache: Das Projekt wurde noch nicht mit der Shadcn-CLI initialisiert.
- Lösung: Führen Sie zuerst
npx shadcn@latest initim Stammverzeichnis Ihres Projekts aus.
Dokumentations- & Hilfeverzeichnis
Wenn Sie detaillierte Dokumentation, Anleitungen oder Unterstützung benötigen, besuchen Sie diese offiziellen Dokumentationsseiten:
| Leitfaden / Ressource | URL | Was Sie finden werden |
|---|---|---|
| Einführung – Erste Schritte | https://shadcnspace.com/docs/getting-started/introduction | Überblick, Philosophie und Repository-Einführung |
| CLI-Installationsanleitung | https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli | Vollständiger CLI-Durchlauf, v3 vs. v2, Videoanleitung und Fehlerbehebung |
| Migration von Radix UI zu Base UI | https://shadcnspace.com/docs/getting-started/migrate-to-baseui | Schritt-für-Schritt-Anleitung zur Migration von asChild zu render und Positioner |
| MCP-Server-Setup-Anleitung | https://shadcnspace.com/docs/getting-started/mcp-server-docs | Konfiguration von Cursor, Windsurf, Claude Code und anderen KI-IDEs |
| Anleitung zur Komponentenverwendung | https://shadcnspace.com/docs/getting-started/component | UI-Primitive, Schaltflächen, Dropdowns, Dialoge, Eingabefelder |
| Blöcke-Anleitung | https://shadcnspace.com/docs/getting-started/blocks | Marketing, Hero, Preise, Testimonials, Bento-Grids und Dashboards |
| Anleitung zur KI-Aufforderung | https://shadcnspace.com/docs/getting-started/copy-prompt | Aufforderungen für einmalige Landingpages und Dashboard-Komposition |
| Interaktiver CLI-Builder | https://shadcnspace.com/cli | Benutzerdefinierter visueller Befehlsersteller für Stile, Designs und Symbole |
| Öffnen in v0-Anleitung | https://shadcnspace.com/docs/getting-started/open-v0 | Öffnen und Anpassen von ShadcnSpace-Blöcken in v0 |
| Interaktive Blockgalerie | https://shadcnspace.com/blocks | Visuelle Live-Vorschau und Code-Kopie für alle über 100 Blöcke |
| Komponentenkatalog | https://shadcnspace.com/components | Mikrointeraktionen, animierter Text, Dock, Laufband |
| Ganzseitige Vorlagen | https://shadcnspace.com/templates | Vollständige, produktionsreife Seitenvorlagen |
| GitHub Issues & Community | https://github.com/shadcnspace/shadcnspace/issues | Fehlermeldungen, Funktionsanfragen und Community-Diskussionen |
ShadcnSpace MCP-Server-Integration
Verbinden Sie den offiziellen ShadcnSpace MCP-Server mit Ihrer KI-IDE (Cursor, Windsurf, Claude Code, Lovable, Bolt oder v0), um UI-Blöcke direkt in Ihrer Chat-Sitzung zu inspizieren, zu durchsuchen und zu installieren.
Cursor-Setup (~/.cursor/mcp.json)
{
"mcpServers": {
"shadcnspace": {
"url": "https://mcp.shadcnspace.com/mcp",
"headers": {
"Authorization": "Bearer [email protected]:your-license-key"
}
}
}
}
(Free-Tier-Benutzer können das headers-Feld weglassen; kostenlose Blöcke werden ohne Authentifizierung installiert).
Windsurf-Setup
Fügen Sie in Windsurf Settings → MCP Servers hinzu:
- Server-URL:
https://mcp.shadcnspace.com/mcp - Autorisierung:
Bearer [email protected]:your-license-key
Claude Code-Setup
claude mcp add shadcnspace https://mcp.shadcnspace.com/mcp
Lovable & Bolt-Setup
- Server-URL:
https://mcp.shadcnspace.com/mcp - Transport:
HTTP - Auth: Bearer-Token
[email protected]:your-license-key
Verfügbare MCP-Tools
| Tool | Zweck |
|---|---|
searchBlocks | Durchsucht Blöcke nach Schlüsselwörtern (z. B. hero, pricing, stats, sidebar) |
listBlocks | Listet alle verfügbaren Blöcke in ShadcnSpace auf |
getBlockInstall | Gibt den genauen CLI-Befehl zur Installation eines Blocks zurück (Base UI oder Radix UI) |
searchPages | Durchsucht ganzseitige Vorlagen |
getPageInstall | Gibt den Installationsbefehl für eine vollständige Seite zurück |
listInstalledBlocks | Überprüft bereits im aktuellen Projekt installierte Blöcke |
get_audit_checklist | Gibt eine Checkliste für Barrierefreiheit, Theming und responsives Design zurück |
Agenten-Verwendungsmuster & Aufforderungen
Wenn Sie einen KI-Agenten in Cursor, Claude Code oder Windsurf auffordern, verwenden Sie diese strukturierten Muster:
Einzelblock-Generierung
Fügen Sie einen konversionsstarken Hero-Bereich für mein SaaS mit ShadcnSpace Hero 01 (Base UI) hinzu.
Erstellen Sie einen Preisbereich mit monatlichem und jährlichem Umschalter mit ShadcnSpace Radix UI Pricing 01.
Fügen Sie eine Admin-Seitenleiste und Statistik-Karten mit ShadcnSpace Dashboard-Blöcken hinzu.
Komplette Landingpage-Komposition (Ein Durchlauf)
Erstellen Sie eine vollständige SaaS-Landingpage mit ShadcnSpace-Blöcken:
- Navbar: Klebrige glasomorphe Navbar von ShadcnSpace
- Hero: Hero 01 mit interaktivem Badge und Videovorschau
- Features: Bento Grid 01 mit Mikroanimationen
- Social Proof: Testimonial-Marquee von ShadcnSpace
- Pricing: Pricing 01 mit 3 Stufen und Abrechnungsumschaltung
- Footer: Footer 01 mit mehrspaltigem Layout
Verwenden Sie Base UI-Varianten. Befolgen Sie die shadcn/ui-Namenskonventionen und exportieren Sie jede Komponente als Standard-Export aus `@/components/shadcn-space/`.
Dashboard-Zusammenstellung
Erstellen Sie ein Produktanalyse-Dashboard mit ShadcnSpace Dashboard-Blöcken:
- Sidebar: Sidebar 01 mit Navigationslinks für Dashboard, Analysen, Einstellungen
- Header: Top-Navigationsleiste mit Benutzerprofil-Menü und Benachrichtigungen
- Übersichtskarten: Statistik-Karten für wöchentliche aktive Benutzer, Umsatz, Abschlussrate
- Datentabellen: Voll ausgestattete Tabelle mit Paginierung und Suchleiste
- Diagramme: Liniendiagramm und Balkendiagramm mit monatlichen Trends
Block-Anpassungsaufforderung
Überprüfen Sie den soeben installierten Hero-01-Block in `src/components/shadcn-space/hero-01.tsx`. Ändern Sie die Hintergrundfarbe auf `bg-gradient-to-br from-blue-50 to-indigo-100`, ersetzen Sie den Platzhaltertext durch „Beschleunigen Sie Ihr Team" und fügen Sie einen sekundären CTA-Button „Mehr erfahren" hinzu, der auf `/features` verweist.
Lizenzierung
ShadcnSpace ist unter der MIT-Lizenz lizenziert — mit Ausnahme der Pro-Blöcke und Premium-Vorlagen, die einen kostenpflichtigen Lizenzschlüssel erfordern.