ShadcnSpace - AI Agent Skill & Developer Guide
ShadcnSpace is the premier open-source distribution and registry of 1000+ Shadcn resources, including production-ready UI blocks, interactive components, pre-designed pages, full-page templates, dashboard systems, marketing sections, and animated micro-interactions built with React, Next.js App Router, Tailwind CSS v4, Base UI, and Radix UI.
Prerequisites - Install the Official shadcn/ui Skill First
For the best AI-assisted experience, install the official shadcn/ui skill alongside this one. It gives your AI assistant deep knowledge of shadcn/ui core components, theming, CLI commands, and project configuration - so the AI never guesses about component APIs, CSS variables, or your project setup.
# npm
npx skills add shadcn/ui
# pnpm
pnpm dlx skills add shadcn/ui
# bun
bunx skills add shadcn/ui
# yarn
yarn dlx skills add shadcn/ui
The official skill automatically reads your components.json to detect your framework, installed components, base library (Base UI / Radix UI / Aria), and Tailwind version - giving the AI full project-aware context.
Why Both Skills Together?
| Layer |
Skill |
What the AI Learns |
| Foundation |
shadcn/ui official skill |
Core components, theming, CLI, components.json, CSS variables, dark mode, Tailwind v3/v4 |
| Extension |
This shadcnspace skill |
500+ blocks, 500+ components, 29 pages, 13 templates, Base UI vs Radix UI parity, MCP tools, AI editor workflows |
With both skills installed, your AI assistant has complete, zero-hallucination knowledge of the entire shadcn ecosystem - from core primitives to production-ready ShadcnSpace blocks.
Verified Inventory & Resource Numbers
The ShadcnSpace ecosystem contains over 1,060+ total production resources:
| Resource Type |
Total Items |
Breakdown & Coverage |
| UI Blocks |
521 Blocks |
328 Marketing, 141 Dashboard UI, 42 Ecommerce, 10 Applications (444 Pro, 77 Free, 97 Animated) |
| UI Components |
511 Components |
484 Free components, 27 Pro components (Apple Dock, Orbiting Circles, Canvas, Shaders, Marquees) |
| Pre-designed Pages |
29 Pages |
Full production-ready pages (SaaS Landing, Portfolio, Agency, Dashboard Home) |
| Full Templates |
13 Templates |
10 Landing Page templates + 3 Application Dashboards (Next.js, Astro, Tailwind v4, React 19) |
| Block Categories |
60 Categories |
Hero, Pricing, Bento Grid, Features, Stats, Testimonials, AI Ops, etc. |
| Component Categories |
68 Categories |
Micro-interactions, Docks, Orbiting circles, Shaders, Loaders, Buttons, etc. |
| Primitive Support |
Dual Variant |
100% parity across Base UI and Radix UI primitives |
Quick Start - How to Use ShadcnSpace
Follow these 4 simple steps to start using ShadcnSpace in any Next.js or React project:
Step 1: Initialize Shadcn in Your Project
If your project does not have Shadcn UI configured yet:
# Initialize shadcn UI
npx shadcn@latest init
Tip: For a pre-configured setup with Base UI and Tailwind CSS v4, use the visual project creator at https://ui.shadcn.com/create.
Step 2: Configure the Registry in components.json
Add the official @shadcn-space registry to your project's components.json file:
For Free Blocks & Components:
{
"$schema": "https://ui.shadcn.com/schema.json",
"style": "base-nova",
"registries": {
"@shadcn-space": "https://shadcnspace.com/r/{name}.json"
}
}
For Pro Users (With License Key):
{
"$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}"
}
}
}
}
Add EMAIL=your@email.com and LICENSE_KEY=your-key into your .env or .env.local file.
Step 3: Install Blocks & Components
Run the installation command using your package manager for either Base UI or Radix UI:
# Base UI (Recommended default)
npx shadcn@latest add @shadcn-space/hero-01
# Radix UI
npx shadcn@latest add @shadcn-space/radix/hero-01
Step 4: Import and Use in Your Code
Components are copied directly into your src/components/shadcn-space/ folder with complete source code ownership:
import Hero01 from "@/components/shadcn-space/hero-01";
export default function LandingPage() {
return (
<main>
<Hero01 />
</main>
);
}
Base UI vs Radix UI - Complete Commands Guide
ShadcnSpace provides dual-variant support: every block, component, and full page is maintained in both Base UI and Radix UI primitives.
Understanding the Difference
- Base UI (Recommended): The modern foundation for shadcn UI. Uses a unified
@base-ui/react package, explicit render props instead of Slot, and separate Positioner components.
- Radix UI: The classic headless foundation. Uses individual
@radix-ui/react-* packages and the asChild prop with Slot.
1. Base UI Commands
Via Registry Namespace (Recommended - Shadcn CLI v3)
# Blocks & Components
npx shadcn@latest add @shadcn-space/<item-name>
# Examples:
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
# Full Pages:
npx shadcn@latest add @shadcn-space/pages/<page-name>
# Example:
npx shadcn@latest add @shadcn-space/pages/landing-page-01
Via Direct URL (Shadcn CLI v2 / Fallback)
# Blocks & Components
npx shadcn@latest add https://shadcnspace.com/r/<item-name>.json
# Pages
npx shadcn@latest add https://shadcnspace.com/r/pages/<page-name>.json
2. Radix UI Commands
Via Registry Namespace (Recommended - Shadcn CLI v3)
# Blocks & Components
npx shadcn@latest add @shadcn-space/radix/<item-name>
# Examples:
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
# Full Pages:
npx shadcn@latest add @shadcn-space/pages/radix/<page-name>
# Example:
npx shadcn@latest add @shadcn-space/pages/radix/landing-page-01
Via Direct URL (Shadcn CLI v2 / Fallback)
# Blocks & Components
npx shadcn@latest add https://shadcnspace.com/r/radix/<item-name>.json
# Pages
npx shadcn@latest add https://shadcnspace.com/r/pages/radix/<page-name>.json
3. Package Manager Syntax
You can run any ShadcnSpace install command across all major package runners:
| Package Manager |
Command Syntax |
| 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. Advanced CLI Commands
# Install multiple blocks in one command:
npx shadcn@latest add @shadcn-space/navbar-01 @shadcn-space/hero-01 @shadcn-space/footer-01
# Force overwrite existing files without confirmation prompts:
npx shadcn@latest add @shadcn-space/hero-01 --overwrite
Full Templates Directory (13 Production Templates)
ShadcnSpace provides 13 full-stack templates ready to download, customize, and deploy:
A. Landing Page Templates (10 Templates)
| Template Name |
Stack & Versions |
Highlights & Best For |
| Saazio |
Next.js 16, React 19, Tailwind CSS v4, shadcn/ui |
SaaS products, AI startups, software tools, conversion-optimized pricing |
| Atomist |
Next.js & Astro versions, Tailwind CSS, shadcn/ui |
Minimal SaaS landing page, features, pricing, services, and blogs |
| Awake |
Next.js & Astro versions, Tailwind CSS v4, shadcn/ui |
Agencies, studios, creative freelancers, modern dark/light showcase |
| Digital Arc |
Next.js & Astro versions, Tailwind CSS, shadcn/ui |
Startup agencies, design studios, high-visual agency portfolio |
| Crypgo |
Next.js & Astro versions, Tailwind CSS, shadcn/ui |
Crypto platforms, Web3 startups, blockchain products, fintech |
| Studiova |
Next.js & Astro versions, Tailwind CSS, shadcn/ui |
Creative web agency, branding showcase, case study grids |
| Typefolio |
Next.js 16, React 19, Tailwind CSS v4 |
Personal developer portfolio, clean typography, work timeline |
| Resume |
Next.js 16, React 19, Tailwind CSS v4 |
Interactive developer CV, skills breakdown, experience cards |
| Homely |
Next.js 16, React 19, Tailwind CSS v4 |
Real estate listings, property agency, architecture showcases |
| Gleamer |
Next.js 16, React 19, Tailwind CSS v4 |
Cleaning & home service businesses, local service booking |
B. Application Dashboard Templates (3 Templates)
| Template Name |
Stack & Versions |
Highlights & Best For |
| AI Chatbox |
Next.js 16, React 19, Tailwind CSS v4, Base UI |
Conversational AI chat, stream messaging, prompt composer, sidebar sessions |
| AI Agent Ops |
Next.js 16, React 19, Tailwind CSS v4, Recharts |
AI monitoring dashboard, token usage charts, model spend, provider latency |
| PMS (Project Management) |
Next.js 16, React 19, Tailwind CSS v4, TanStack |
Full project management dashboard, team boards, tasks, sprints, and metrics |
ShadcnSpace MCP Server Integration
Connect the official ShadcnSpace MCP server to your AI IDE (Cursor, Windsurf, Claude Code, Lovable, Bolt, or v0) to inspect, search, and install UI blocks directly inside your chat session.
Cursor Setup (~/.cursor/mcp.json)
{
"mcpServers": {
"shadcnspace": {
"url": "https://mcp.shadcnspace.com/mcp",
"headers": {
"Authorization": "Bearer your@email.com:your-license-key"
}
}
}
}
(Free tier users can omit the headers field; free blocks install without authentication).
Windsurf Setup
In Windsurf Settings -> MCP Servers, add:
- Server URL:
https://mcp.shadcnspace.com/mcp
- Authorization:
Bearer your@email.com: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
your@email.com:your-license-key
Need Help or Troubleshooting?
Once connected, your AI assistant will automatically discover and list all available tools. If you run into any connection issues, check the official documentation:
AI Editor Workflows & Ready Prompts
Use these structured prompts in Cursor, Claude Code, Windsurf, Bolt.new, Lovable, or v0 to get clean, working code without missing dependencies:
1. Single Block Generation
Add a high-converting hero section for my SaaS using ShadcnSpace Hero 01 (Base UI).
Make sure to keep all semantic Tailwind color tokens and smooth motion micro-interactions.
Create a pricing section with monthly and annual toggle using ShadcnSpace Radix UI Pricing 01.
Ensure proper responsive grid layouts and active card highlights.
Add an admin sidebar and stats cards using ShadcnSpace Dashboard UI blocks.
Connect TanStack Table and Recharts components with mock metrics data.
2. Full Landing Page Composition (One-Pass Recipe)
Build a complete SaaS landing page using ShadcnSpace blocks:
- Navbar: Sticky glassmorphic navbar with mobile sheet navigation (@shadcn-space/navbar-01)
- Hero: Hero section with trusted badge, CTA buttons, and video mockup (@shadcn-space/hero-01)
- Social Proof: Infinite partner logo cloud ticker (@shadcn-space/logo-cloud-01)
- Features: Asymmetric Bento Grid with interactive cards (@shadcn-space/bento-grid-01)
- Metrics: Animated statistics counter cards (@shadcn-space/statistics-01)
- Testimonials: Infinite avatar testimonial marquee (@shadcn-space/testimonials-01)
- Pricing: 3-tier pricing card comparison with monthly/annual switch (@shadcn-space/pricing-01)
- FAQ: Accessible accordion with collapsible answers (@shadcn-space/faq-01)
- CTA: High-impact gradient card with email newsletter input (@shadcn-space/cta-01)
- Footer: Multi-column sitemap with social links and copyright (@shadcn-space/footer-01)
3. Application Dashboard Composition
Build a modern SaaS analytics dashboard using ShadcnSpace:
- Sidebar: Collapsible multi-tier navigation with workspace switcher and user profile
- Header: Sticky header with global search, notifications popover, and theme toggle
- Metric Cards: 4 KPI metric cards with sparkline trend delta badges
- Chart Section: Recharts revenue area chart with timeframe tab filters
- Data Table: TanStack Table with fuzzy search, column filters, and bulk status actions
Block & Component Taxonomy
Explore the full interactive gallery at https://shadcnspace.com/blocks:
1. Marketing & SaaS Landing Pages (328 Blocks)
- Hero Sections: Conversational, media-split, video-embed, and badge-accented heroes.
- Bento Grids: Asymmetric feature grids with interactive cards, badges, and counters.
- Feature Sections: Tabbed showcases, sticky scroll-stacking cards, and icon lists.
- Pricing Sections: Tier comparisons, annual discount toggles, and feature checklists.
- Testimonials: Infinite review marquees, avatar groups, and quotes.
- Navbar & Headers: Sticky glassmorphism navbars, desktop drop-menus, mobile sheets.
- Footers: Multi-column sitemaps, newsletter forms, social badges.
- CTAs: Gradient cards, newsletter signups, quick trial buttons.
- Logo Clouds: Infinite partner tickers and social proof badges.
- FAQs: Accessible accordion FAQs with category filtering.
- About Us & Team: Agency stories, timeline milestones, leadership grids.
- Blog & Article Grids: Editorial cards, featured articles, tag filtering.
2. Dashboard UI & Admin Systems (141 Blocks)
- Dashboard Shells: Responsive master-detail shells with sidebars and sticky headers.
- Sidebars: Collapsible multi-tier navigation with team switchers and user profiles.
- Statistics & Metric Cards: KPI cards with delta trends and sparklines.
- Charts: Recharts and ApexCharts line, area, bar, and donut charts.
- Data Tables: TanStack Table with fuzzy search, column sorting, pagination, and bulk actions.
- Forms: React Hook Form + Zod with clean validation states.
3. Ecommerce Sections (42 Blocks)
- Product Grids & Showcases: Filterable product cards, hover quick-views, rating badges.
- Checkout & Cart: Multi-step checkout flows, discount code drawers, order review sheets.
- Order Confirmation: Tracking steps, invoice receipt summary, customer assistance card.
4. Application Interfaces (10 Blocks)
- AI Chat & Prompts: Message scrollers, streaming text bubbles, input prompt bars with attachments.
- AI Ops Monitoring: Token counters, model latency graphs, cost breakdown cards.
- Kanban Boards: Drag-and-drop task workflows with status tags.
- Notes & Documents: Document tree sidebar with distraction-free editor layouts.
- Calendars & Scheduling: Date range pickers and timeline views.
5. Animated Interactive Components (511 Components)
- Apple Dock: Magnified dock inspired by macOS.
- Marquee: High-performance infinite scrolling marquee.
- Orbiting Circles: Smooth planetary orbit animations.
- Animated Text: Shimmer, typing, blur-fade, and gradient text.
- WebGL Shaders: Liquid background canvas, gradient waves, particle constellations.
Troubleshooting & Problem Solving
If you encounter issues when installing or using ShadcnSpace, use these fixes:
1. Problem: "Block / Component Not Found"
- Cause: The component slug is mistyped, or
@shadcn-space registry is missing in components.json.
- Solution:
- Verify the exact block name at https://shadcnspace.com/blocks.
- Confirm your
components.json has:"registries": {
"@shadcn-space": "https://shadcnspace.com/r/{name}.json"
}
- If installing a Radix UI component, make sure you prefix with
radix/:
npx shadcn@latest add @shadcn-space/radix/<name>.
- If installing a page, ensure the prefix is
pages/:
npx shadcn@latest add @shadcn-space/pages/<name>.
2. Problem: "Access Denied / 401 Unauthorized / Missing Credentials"
- Cause: Trying to install a Pro block without authentication.
- Solution:
- Add your credentials to your project's
.env or .env.local:EMAIL=your@email.com
LICENSE_KEY=your-license-key
- Ensure your
components.json specifies params for @shadcn-space:"registries": {
"@shadcn-space": {
"url": "https://shadcnspace.com/r/{name}.json",
"params": {
"email": "${EMAIL}",
"license_key": "${LICENSE_KEY}"
}
}
}
- Re-run your terminal or command prompt so the environment variables take effect.
3. Problem: Primitives / TypeScript Type Mismatch (Base UI vs Radix UI)
- Cause: Using a Radix UI block in a project that only has Base UI installed, or vice-versa.
- Symptoms:
Module not found: Can't resolve '@radix-ui/react-...' or Cannot find module '@base-ui/react'.
- Solution:
- If your project uses Base UI: install the standard Base UI variant (
@shadcn-space/<name>). Ensure @base-ui/react is installed (pnpm add @base-ui/react).
- If your project uses Radix UI: install the Radix variant (
@shadcn-space/radix/<name>). Ensure required @radix-ui/react-* packages are present.
- To migrate an existing project from Radix to Base UI, follow the Migration Guide.
4. Problem: "File already exists" prompt or conflict
5. Problem: Broken Styling or Missing Colors
- Cause: Missing semantic color tokens (
--background, --foreground, --primary, --border, etc.) in globals.css.
- Solution: ShadcnSpace utilizes standard CSS variable tokens. Make sure your
globals.css or Tailwind CSS v4 @theme includes semantic design tokens. Do not hardcode arbitrary hex codes.
6. Problem: components.json Not Found
- Cause: The project has not been initialized with shadcn CLI yet.
- Solution: Run
npx shadcn@latest init first in the root of your project.
Documentation & Help Directory
When you need detailed documentation, guides, or assistance, visit these official documentation pages:
| Guide / Resource |
URL |
What You'll Find |
| Getting Started Introduction |
https://shadcnspace.com/docs/getting-started/introduction |
Overview, philosophy, and repository introduction |
| CLI Installation Guide |
https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli |
Complete CLI walkthrough, v3 vs v2, video guide, and troubleshooting |
| Radix UI to Base UI Migration |
https://shadcnspace.com/docs/getting-started/migrate-to-baseui |
Step-by-step guide to migrate code from asChild to render and Positioner |
| MCP Server Setup Guide |
https://shadcnspace.com/docs/getting-started/mcp-server-docs |
Configuring Cursor, Windsurf, Claude Code, and other AI IDEs |
| Component Usage Guide |
https://shadcnspace.com/docs/getting-started/component |
UI primitives, buttons, dropdowns, dialogs, inputs |
| Blocks Guide |
https://shadcnspace.com/docs/getting-started/blocks |
Marketing, hero, pricing, testimonials, bento grids, and dashboards |
| AI Prompting Guide |
https://shadcnspace.com/docs/getting-started/copy-prompt |
Prompts for single-pass landing pages and dashboard composition |
| Interactive CLI Builder |
https://shadcnspace.com/cli |
Custom visual command builder for styles, themes, and icons |
| Open in v0 Guide |
https://shadcnspace.com/docs/getting-started/open-v0 |
Opening and customizing ShadcnSpace blocks inside v0 |
| Interactive Blocks Gallery |
https://shadcnspace.com/blocks |
Visual live preview and copy code for all 500+ blocks |
| Components Catalog |
https://shadcnspace.com/components |
Micro-interactions, animated text, dock, marquee |
| Full Page Templates |
https://shadcnspace.com/templates |
Complete production-ready page templates |
| GitHub Issues & Community |
https://github.com/shadcnspace/shadcnspace/issues |
Bug reports, feature requests, and community discussions |
Design System & Anti-Slop Rules
- Semantic Design Tokens:
Use CSS variables and semantic Tailwind classes:
bg-background, bg-card, text-foreground, text-muted-foreground, border-border, bg-primary text-primary-foreground.
Never use arbitrary hardcoded hex codes (bg-[#0a0a0a]).
- Dual-Theme Parity:
All blocks must look polished in both Light and Dark mode without contrast issues.
- Primitives Compatibility:
Supports both Base UI (
render prop) and Radix UI (asChild prop).
- Motion Restraint:
Use purposeful spring micro-interactions (
motion/react). Always respect prefers-reduced-motion.
- Interactive Link Polish:
Every
<a> element must feature an explicit hover state (hover:underline, hover:text-primary).
Never nest <button> inside <a> or vice-versa.
1---2name: shadcnspace-skills3description: Production UI component library with MCP server integration, 1000+ Shadcn resources, blocks, components, templates, and dashboard layouts. Use this skill when building modern React and Next.js UI, designing landing pages, selecting dashboard layouts, creating marketing sections, or replacing generic shadcn/ui components with production-grade ShadcnSpace blocks.4license: MIT5compatibility: Next.js 14+, React 19/18, Tailwind CSS v4/v3, Base UI, Radix UI, Shadcn CLI, Cursor, Claude Code, Windsurf, Lovable, Bolt6metadata:7 source: https://skillmd.com/skills/wrappixel/shadcnspace-skills8 author: "shadcnspace"9 website: "https://shadcnspace.com"10 registry: "https://shadcnspace.com/r"11 documentation: "https://shadcnspace.com/docs"12 mcp: "https://mcp.shadcnspace.com/mcp"13 github: "https://github.com/shadcnspace/shadcnspace"14---1516# ShadcnSpace - AI Agent Skill & Developer Guide1718[ShadcnSpace](https://shadcnspace.com) is the premier open-source distribution and registry of 1000+ Shadcn resources, including production-ready UI blocks, interactive components, pre-designed pages, full-page templates, dashboard systems, marketing sections, and animated micro-interactions built with React, Next.js App Router, Tailwind CSS v4, Base UI, and Radix UI.1920- **Website**: [https://shadcnspace.com](https://shadcnspace.com)21- **Block Directory**: [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks)22- **Component Directory**: [https://shadcnspace.com/components](https://shadcnspace.com/components)23- **Full-Page Templates**: [https://shadcnspace.com/templates](https://shadcnspace.com/templates)24- **Documentation**: [https://shadcnspace.com/docs](https://shadcnspace.com/docs)25- **MCP Server**: `https://mcp.shadcnspace.com/mcp`26- **GitHub**: [https://github.com/shadcnspace/shadcnspace](https://github.com/shadcnspace/shadcnspace)2728---2930## Prerequisites - Install the Official shadcn/ui Skill First3132For the best AI-assisted experience, install the **official shadcn/ui skill** alongside this one. It gives your AI assistant deep knowledge of shadcn/ui core components, theming, CLI commands, and project configuration - so the AI never guesses about component APIs, CSS variables, or your project setup.3334```bash35# npm36npx skills add shadcn/ui3738# pnpm39pnpm dlx skills add shadcn/ui4041# bun42bunx skills add shadcn/ui4344# yarn45yarn dlx skills add shadcn/ui46```4748The official skill automatically reads your `components.json` to detect your framework, installed components, base library (Base UI / Radix UI / Aria), and Tailwind version - giving the AI full project-aware context.4950### Why Both Skills Together?5152| Layer | Skill | What the AI Learns |53| -------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------- |54| **Foundation** | `shadcn/ui` official skill | Core components, theming, CLI, `components.json`, CSS variables, dark mode, Tailwind v3/v4 |55| **Extension** | This `shadcnspace` skill | 500+ blocks, 500+ components, 29 pages, 13 templates, Base UI vs Radix UI parity, MCP tools, AI editor workflows |5657With both skills installed, your AI assistant has **complete, zero-hallucination knowledge** of the entire shadcn ecosystem - from core primitives to production-ready ShadcnSpace blocks.5859---6061## Verified Inventory & Resource Numbers6263The ShadcnSpace ecosystem contains over **1,060+** total production resources:6465| Resource Type | Total Items | Breakdown & Coverage |66| ------------------------ | ------------------ | ------------------------------------------------------------------------------------------------ |67| **UI Blocks** | **521 Blocks** | 328 Marketing, 141 Dashboard UI, 42 Ecommerce, 10 Applications (444 Pro, 77 Free, 97 Animated) |68| **UI Components** | **511 Components** | 484 Free components, 27 Pro components (Apple Dock, Orbiting Circles, Canvas, Shaders, Marquees) |69| **Pre-designed Pages** | **29 Pages** | Full production-ready pages (SaaS Landing, Portfolio, Agency, Dashboard Home) |70| **Full Templates** | **13 Templates** | 10 Landing Page templates + 3 Application Dashboards (Next.js, Astro, Tailwind v4, React 19) |71| **Block Categories** | **60 Categories** | Hero, Pricing, Bento Grid, Features, Stats, Testimonials, AI Ops, etc. |72| **Component Categories** | **68 Categories** | Micro-interactions, Docks, Orbiting circles, Shaders, Loaders, Buttons, etc. |73| **Primitive Support** | **Dual Variant** | 100% parity across **Base UI** and **Radix UI** primitives |7475---7677## Quick Start - How to Use ShadcnSpace7879Follow these 4 simple steps to start using ShadcnSpace in any Next.js or React project:8081### Step 1: Initialize Shadcn in Your Project8283If your project does not have Shadcn UI configured yet:8485```bash86# Initialize shadcn UI87npx shadcn@latest init88```8990_Tip: For a pre-configured setup with Base UI and Tailwind CSS v4, use the visual project creator at [https://ui.shadcn.com/create](https://ui.shadcn.com/create)._9192---9394### Step 2: Configure the Registry in `components.json`9596Add the official `@shadcn-space` registry to your project's `components.json` file:9798#### For Free Blocks & Components:99100```json101{102 "$schema": "https://ui.shadcn.com/schema.json",103 "style": "base-nova",104 "registries": {105 "@shadcn-space": "https://shadcnspace.com/r/{name}.json"106 }107}108```109110#### For Pro Users (With License Key):111112```json113{114 "$schema": "https://ui.shadcn.com/schema.json",115 "style": "base-nova",116 "registries": {117 "@shadcn-space": {118 "url": "https://shadcnspace.com/r/{name}.json",119 "params": {120 "email": "${EMAIL}",121 "license_key": "${LICENSE_KEY}"122 }123 }124 }125}126```127128_Add `EMAIL=your@email.com` and `LICENSE_KEY=your-key` into your `.env` or `.env.local` file._129130---131132### Step 3: Install Blocks & Components133134Run the installation command using your package manager for either **Base UI** or **Radix UI**:135136```bash137# Base UI (Recommended default)138npx shadcn@latest add @shadcn-space/hero-01139140# Radix UI141npx shadcn@latest add @shadcn-space/radix/hero-01142```143144---145146### Step 4: Import and Use in Your Code147148Components are copied directly into your `src/components/shadcn-space/` folder with complete source code ownership:149150```tsx151import Hero01 from "@/components/shadcn-space/hero-01";152153export default function LandingPage() {154 return (155 <main>156 <Hero01 />157 </main>158 );159}160```161162---163164## Base UI vs Radix UI - Complete Commands Guide165166ShadcnSpace provides **dual-variant support**: every block, component, and full page is maintained in both **Base UI** and **Radix UI** primitives.167168### Understanding the Difference169170- **Base UI (Recommended)**: The modern foundation for shadcn UI. Uses a unified `@base-ui/react` package, explicit `render` props instead of `Slot`, and separate `Positioner` components.171- **Radix UI**: The classic headless foundation. Uses individual `@radix-ui/react-*` packages and the `asChild` prop with `Slot`.172173### 1. Base UI Commands174175#### Via Registry Namespace (Recommended - Shadcn CLI v3)176177```bash178# Blocks & Components179npx shadcn@latest add @shadcn-space/<item-name>180181# Examples:182npx shadcn@latest add @shadcn-space/hero-01183npx shadcn@latest add @shadcn-space/bento-grid-01184npx shadcn@latest add @shadcn-space/button-06185npx shadcn@latest add @shadcn-space/pricing-01186npx shadcn@latest add @shadcn-space/sidebar-01187188# Full Pages:189npx shadcn@latest add @shadcn-space/pages/<page-name>190# Example:191npx shadcn@latest add @shadcn-space/pages/landing-page-01192```193194#### Via Direct URL (Shadcn CLI v2 / Fallback)195196```bash197# Blocks & Components198npx shadcn@latest add https://shadcnspace.com/r/<item-name>.json199200# Pages201npx shadcn@latest add https://shadcnspace.com/r/pages/<page-name>.json202```203204---205206### 2. Radix UI Commands207208#### Via Registry Namespace (Recommended - Shadcn CLI v3)209210```bash211# Blocks & Components212npx shadcn@latest add @shadcn-space/radix/<item-name>213214# Examples:215npx shadcn@latest add @shadcn-space/radix/hero-01216npx shadcn@latest add @shadcn-space/radix/bento-grid-01217npx shadcn@latest add @shadcn-space/radix/button-06218npx shadcn@latest add @shadcn-space/radix/pricing-01219npx shadcn@latest add @shadcn-space/radix/sidebar-01220221# Full Pages:222npx shadcn@latest add @shadcn-space/pages/radix/<page-name>223# Example:224npx shadcn@latest add @shadcn-space/pages/radix/landing-page-01225```226227#### Via Direct URL (Shadcn CLI v2 / Fallback)228229```bash230# Blocks & Components231npx shadcn@latest add https://shadcnspace.com/r/radix/<item-name>.json232233# Pages234npx shadcn@latest add https://shadcnspace.com/r/pages/radix/<page-name>.json235```236237---238239### 3. Package Manager Syntax240241You can run any ShadcnSpace install command across all major package runners:242243| Package Manager | Command Syntax |244| --------------- | --------------------------------------------------- |245| **npm** | `npx shadcn@latest add @shadcn-space/<name>` |246| **pnpm** | `pnpm dlx shadcn@latest add @shadcn-space/<name>` |247| **bun** | `bunx --bun shadcn@latest add @shadcn-space/<name>` |248| **yarn** | `yarn dlx shadcn@latest add @shadcn-space/<name>` |249250### 4. Advanced CLI Commands251252```bash253# Install multiple blocks in one command:254npx shadcn@latest add @shadcn-space/navbar-01 @shadcn-space/hero-01 @shadcn-space/footer-01255256# Force overwrite existing files without confirmation prompts:257npx shadcn@latest add @shadcn-space/hero-01 --overwrite258```259260---261262## Full Templates Directory (13 Production Templates)263264ShadcnSpace provides 13 full-stack templates ready to download, customize, and deploy:265266### A. Landing Page Templates (10 Templates)267268| Template Name | Stack & Versions | Highlights & Best For |269| --------------- | ---------------------------------------------------- | ------------------------------------------------------------------------ |270| **Saazio** | Next.js 16, React 19, Tailwind CSS v4, shadcn/ui | SaaS products, AI startups, software tools, conversion-optimized pricing |271| **Atomist** | Next.js & Astro versions, Tailwind CSS, shadcn/ui | Minimal SaaS landing page, features, pricing, services, and blogs |272| **Awake** | Next.js & Astro versions, Tailwind CSS v4, shadcn/ui | Agencies, studios, creative freelancers, modern dark/light showcase |273| **Digital Arc** | Next.js & Astro versions, Tailwind CSS, shadcn/ui | Startup agencies, design studios, high-visual agency portfolio |274| **Crypgo** | Next.js & Astro versions, Tailwind CSS, shadcn/ui | Crypto platforms, Web3 startups, blockchain products, fintech |275| **Studiova** | Next.js & Astro versions, Tailwind CSS, shadcn/ui | Creative web agency, branding showcase, case study grids |276| **Typefolio** | Next.js 16, React 19, Tailwind CSS v4 | Personal developer portfolio, clean typography, work timeline |277| **Resume** | Next.js 16, React 19, Tailwind CSS v4 | Interactive developer CV, skills breakdown, experience cards |278| **Homely** | Next.js 16, React 19, Tailwind CSS v4 | Real estate listings, property agency, architecture showcases |279| **Gleamer** | Next.js 16, React 19, Tailwind CSS v4 | Cleaning & home service businesses, local service booking |280281### B. Application Dashboard Templates (3 Templates)282283| Template Name | Stack & Versions | Highlights & Best For |284| ---------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------- |285| **AI Chatbox** | Next.js 16, React 19, Tailwind CSS v4, Base UI | Conversational AI chat, stream messaging, prompt composer, sidebar sessions |286| **AI Agent Ops** | Next.js 16, React 19, Tailwind CSS v4, Recharts | AI monitoring dashboard, token usage charts, model spend, provider latency |287| **PMS (Project Management)** | Next.js 16, React 19, Tailwind CSS v4, TanStack | Full project management dashboard, team boards, tasks, sprints, and metrics |288289---290291## ShadcnSpace MCP Server Integration292293Connect the official ShadcnSpace MCP server to your AI IDE (Cursor, Windsurf, Claude Code, Lovable, Bolt, or v0) to inspect, search, and install UI blocks directly inside your chat session.294295### Cursor Setup (`~/.cursor/mcp.json`)296297```json298{299 "mcpServers": {300 "shadcnspace": {301 "url": "https://mcp.shadcnspace.com/mcp",302 "headers": {303 "Authorization": "Bearer your@email.com:your-license-key"304 }305 }306 }307}308```309310_(Free tier users can omit the `headers` field; free blocks install without authentication)._311312### Windsurf Setup313314In **Windsurf Settings -> MCP Servers**, add:315316- **Server URL**: `https://mcp.shadcnspace.com/mcp`317- **Authorization**: `Bearer your@email.com:your-license-key`318319### Claude Code Setup320321```bash322claude mcp add shadcnspace https://mcp.shadcnspace.com/mcp323```324325### Lovable & Bolt Setup326327- **Server URL**: `https://mcp.shadcnspace.com/mcp`328- **Transport**: `HTTP`329- **Auth**: Bearer token `your@email.com:your-license-key`330331### Need Help or Troubleshooting?332333Once connected, your AI assistant will automatically discover and list all available tools. If you run into any connection issues, check the official documentation:334335- **MCP Server Docs**: [https://shadcnspace.com/docs/getting-started/mcp-server-docs](https://shadcnspace.com/docs/getting-started/mcp-server-docs)336337---338339## AI Editor Workflows & Ready Prompts340341Use these structured prompts in Cursor, Claude Code, Windsurf, Bolt.new, Lovable, or v0 to get clean, working code without missing dependencies:342343### 1. Single Block Generation344345```346Add a high-converting hero section for my SaaS using ShadcnSpace Hero 01 (Base UI).347Make sure to keep all semantic Tailwind color tokens and smooth motion micro-interactions.348```349350```351Create a pricing section with monthly and annual toggle using ShadcnSpace Radix UI Pricing 01.352Ensure proper responsive grid layouts and active card highlights.353```354355```356Add an admin sidebar and stats cards using ShadcnSpace Dashboard UI blocks.357Connect TanStack Table and Recharts components with mock metrics data.358```359360### 2. Full Landing Page Composition (One-Pass Recipe)361362```363Build a complete SaaS landing page using ShadcnSpace blocks:364- Navbar: Sticky glassmorphic navbar with mobile sheet navigation (@shadcn-space/navbar-01)365- Hero: Hero section with trusted badge, CTA buttons, and video mockup (@shadcn-space/hero-01)366- Social Proof: Infinite partner logo cloud ticker (@shadcn-space/logo-cloud-01)367- Features: Asymmetric Bento Grid with interactive cards (@shadcn-space/bento-grid-01)368- Metrics: Animated statistics counter cards (@shadcn-space/statistics-01)369- Testimonials: Infinite avatar testimonial marquee (@shadcn-space/testimonials-01)370- Pricing: 3-tier pricing card comparison with monthly/annual switch (@shadcn-space/pricing-01)371- FAQ: Accessible accordion with collapsible answers (@shadcn-space/faq-01)372- CTA: High-impact gradient card with email newsletter input (@shadcn-space/cta-01)373- Footer: Multi-column sitemap with social links and copyright (@shadcn-space/footer-01)374```375376### 3. Application Dashboard Composition377378```379Build a modern SaaS analytics dashboard using ShadcnSpace:380- Sidebar: Collapsible multi-tier navigation with workspace switcher and user profile381- Header: Sticky header with global search, notifications popover, and theme toggle382- Metric Cards: 4 KPI metric cards with sparkline trend delta badges383- Chart Section: Recharts revenue area chart with timeframe tab filters384- Data Table: TanStack Table with fuzzy search, column filters, and bulk status actions385```386387---388389## Block & Component Taxonomy390391Explore the full interactive gallery at **[https://shadcnspace.com/blocks](https://shadcnspace.com/blocks)**:392393### 1. Marketing & SaaS Landing Pages (328 Blocks)394395- **[Hero Sections](https://shadcnspace.com/blocks/marketing/hero-section)**: Conversational, media-split, video-embed, and badge-accented heroes.396- **[Bento Grids](https://shadcnspace.com/blocks/marketing/feature-section)**: Asymmetric feature grids with interactive cards, badges, and counters.397- **[Feature Sections](https://shadcnspace.com/blocks/marketing/feature-section)**: Tabbed showcases, sticky scroll-stacking cards, and icon lists.398- **[Pricing Sections](https://shadcnspace.com/blocks/marketing/pricing-section)**: Tier comparisons, annual discount toggles, and feature checklists.399- **[Testimonials](https://shadcnspace.com/blocks/marketing/testimonials-section)**: Infinite review marquees, avatar groups, and quotes.400- **[Navbar & Headers](https://shadcnspace.com/blocks/marketing/navbar-section)**: Sticky glassmorphism navbars, desktop drop-menus, mobile sheets.401- **[Footers](https://shadcnspace.com/blocks/marketing/footer-section)**: Multi-column sitemaps, newsletter forms, social badges.402- **[CTAs](https://shadcnspace.com/blocks/marketing/cta-section)**: Gradient cards, newsletter signups, quick trial buttons.403- **[Logo Clouds](https://shadcnspace.com/blocks/marketing/logo-cloud)**: Infinite partner tickers and social proof badges.404- **[FAQs](https://shadcnspace.com/blocks/marketing/faq-section)**: Accessible accordion FAQs with category filtering.405- **[About Us & Team](https://shadcnspace.com/blocks/marketing/about-us-section)**: Agency stories, timeline milestones, leadership grids.406- **[Blog & Article Grids](https://shadcnspace.com/blocks/marketing/blog-section)**: Editorial cards, featured articles, tag filtering.407408### 2. Dashboard UI & Admin Systems (141 Blocks)409410- **[Dashboard Shells](https://shadcnspace.com/blocks/dashboard-ui/dashboard-shell)**: Responsive master-detail shells with sidebars and sticky headers.411- **[Sidebars](https://shadcnspace.com/blocks/dashboard-ui/sidebars)**: Collapsible multi-tier navigation with team switchers and user profiles.412- **[Statistics & Metric Cards](https://shadcnspace.com/blocks/dashboard-ui/statistics-component)**: KPI cards with delta trends and sparklines.413- **[Charts](https://shadcnspace.com/blocks/dashboard-ui/charts-component)**: Recharts and ApexCharts line, area, bar, and donut charts.414- **[Data Tables](https://shadcnspace.com/blocks/dashboard-ui/tables)**: TanStack Table with fuzzy search, column sorting, pagination, and bulk actions.415- **[Forms](https://shadcnspace.com/blocks/dashboard-ui/forms)**: React Hook Form + Zod with clean validation states.416417### 3. Ecommerce Sections (42 Blocks)418419- **Product Grids & Showcases**: Filterable product cards, hover quick-views, rating badges.420- **Checkout & Cart**: Multi-step checkout flows, discount code drawers, order review sheets.421- **Order Confirmation**: Tracking steps, invoice receipt summary, customer assistance card.422423### 4. Application Interfaces (10 Blocks)424425- **AI Chat & Prompts**: Message scrollers, streaming text bubbles, input prompt bars with attachments.426- **AI Ops Monitoring**: Token counters, model latency graphs, cost breakdown cards.427- **Kanban Boards**: Drag-and-drop task workflows with status tags.428- **Notes & Documents**: Document tree sidebar with distraction-free editor layouts.429- **Calendars & Scheduling**: Date range pickers and timeline views.430431### 5. Animated Interactive Components (511 Components)432433- **[Apple Dock](https://shadcnspace.com/components/apple-dock)**: Magnified dock inspired by macOS.434- **[Marquee](https://shadcnspace.com/components/marquee)**: High-performance infinite scrolling marquee.435- **[Orbiting Circles](https://shadcnspace.com/components/orbiting-circles)**: Smooth planetary orbit animations.436- **[Animated Text](https://shadcnspace.com/components/animated-text)**: Shimmer, typing, blur-fade, and gradient text.437- **WebGL Shaders**: Liquid background canvas, gradient waves, particle constellations.438439---440441## Troubleshooting & Problem Solving442443If you encounter issues when installing or using ShadcnSpace, use these fixes:444445### 1. Problem: "Block / Component Not Found"446447- **Cause**: The component slug is mistyped, or `@shadcn-space` registry is missing in `components.json`.448- **Solution**:449 1. Verify the exact block name at [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks).450 2. Confirm your `components.json` has:451 ```json452 "registries": {453 "@shadcn-space": "https://shadcnspace.com/r/{name}.json"454 }455 ```456 3. If installing a Radix UI component, make sure you prefix with `radix/`:457 `npx shadcn@latest add @shadcn-space/radix/<name>`.458 4. If installing a page, ensure the prefix is `pages/`:459 `npx shadcn@latest add @shadcn-space/pages/<name>`.460461### 2. Problem: "Access Denied / 401 Unauthorized / Missing Credentials"462463- **Cause**: Trying to install a Pro block without authentication.464- **Solution**:465 1. Add your credentials to your project's `.env` or `.env.local`:466 ```env467 EMAIL=your@email.com468 LICENSE_KEY=your-license-key469 ```470 2. Ensure your `components.json` specifies `params` for `@shadcn-space`:471 ```json472 "registries": {473 "@shadcn-space": {474 "url": "https://shadcnspace.com/r/{name}.json",475 "params": {476 "email": "${EMAIL}",477 "license_key": "${LICENSE_KEY}"478 }479 }480 }481 ```482 3. Re-run your terminal or command prompt so the environment variables take effect.483484### 3. Problem: Primitives / TypeScript Type Mismatch (Base UI vs Radix UI)485486- **Cause**: Using a Radix UI block in a project that only has Base UI installed, or vice-versa.487- **Symptoms**: `Module not found: Can't resolve '@radix-ui/react-...'` or `Cannot find module '@base-ui/react'`.488- **Solution**:489 - If your project uses Base UI: install the standard Base UI variant (`@shadcn-space/<name>`). Ensure `@base-ui/react` is installed (`pnpm add @base-ui/react`).490 - If your project uses Radix UI: install the Radix variant (`@shadcn-space/radix/<name>`). Ensure required `@radix-ui/react-*` packages are present.491 - To migrate an existing project from Radix to Base UI, follow the [Migration Guide](https://shadcnspace.com/docs/getting-started/migrate-to-baseui).492493### 4. Problem: "File already exists" prompt or conflict494495- **Cause**: The component or an underlying dependency file was already installed.496- **Solution**: Pass the `--overwrite` flag:497 ```bash498 npx shadcn@latest add @shadcn-space/hero-01 --overwrite499 ```500501### 5. Problem: Broken Styling or Missing Colors502503- **Cause**: Missing semantic color tokens (`--background`, `--foreground`, `--primary`, `--border`, etc.) in `globals.css`.504- **Solution**: ShadcnSpace utilizes standard CSS variable tokens. Make sure your `globals.css` or Tailwind CSS v4 `@theme` includes semantic design tokens. Do not hardcode arbitrary hex codes.505506### 6. Problem: `components.json` Not Found507508- **Cause**: The project has not been initialized with shadcn CLI yet.509- **Solution**: Run `npx shadcn@latest init` first in the root of your project.510511---512513## Documentation & Help Directory514515When you need detailed documentation, guides, or assistance, visit these official documentation pages:516517| Guide / Resource | URL | What You'll Find |518| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |519| **Getting Started Introduction** | [https://shadcnspace.com/docs/getting-started/introduction](https://shadcnspace.com/docs/getting-started/introduction) | Overview, philosophy, and repository introduction |520| **CLI Installation Guide** | [https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli](https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli) | Complete CLI walkthrough, v3 vs v2, video guide, and troubleshooting |521| **Radix UI to Base UI Migration** | [https://shadcnspace.com/docs/getting-started/migrate-to-baseui](https://shadcnspace.com/docs/getting-started/migrate-to-baseui) | Step-by-step guide to migrate code from `asChild` to `render` and `Positioner` |522| **MCP Server Setup Guide** | [https://shadcnspace.com/docs/getting-started/mcp-server-docs](https://shadcnspace.com/docs/getting-started/mcp-server-docs) | Configuring Cursor, Windsurf, Claude Code, and other AI IDEs |523| **Component Usage Guide** | [https://shadcnspace.com/docs/getting-started/component](https://shadcnspace.com/docs/getting-started/component) | UI primitives, buttons, dropdowns, dialogs, inputs |524| **Blocks Guide** | [https://shadcnspace.com/docs/getting-started/blocks](https://shadcnspace.com/docs/getting-started/blocks) | Marketing, hero, pricing, testimonials, bento grids, and dashboards |525| **AI Prompting Guide** | [https://shadcnspace.com/docs/getting-started/copy-prompt](https://shadcnspace.com/docs/getting-started/copy-prompt) | Prompts for single-pass landing pages and dashboard composition |526| **Interactive CLI Builder** | [https://shadcnspace.com/cli](https://shadcnspace.com/cli) | Custom visual command builder for styles, themes, and icons |527| **Open in v0 Guide** | [https://shadcnspace.com/docs/getting-started/open-v0](https://shadcnspace.com/docs/getting-started/open-v0) | Opening and customizing ShadcnSpace blocks inside v0 |528| **Interactive Blocks Gallery** | [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks) | Visual live preview and copy code for all 500+ blocks |529| **Components Catalog** | [https://shadcnspace.com/components](https://shadcnspace.com/components) | Micro-interactions, animated text, dock, marquee |530| **Full Page Templates** | [https://shadcnspace.com/templates](https://shadcnspace.com/templates) | Complete production-ready page templates |531| **GitHub Issues & Community** | [https://github.com/shadcnspace/shadcnspace/issues](https://github.com/shadcnspace/shadcnspace/issues) | Bug reports, feature requests, and community discussions |532533---534535## Design System & Anti-Slop Rules5365371. **Semantic Design Tokens**:538 Use CSS variables and semantic Tailwind classes:539 `bg-background`, `bg-card`, `text-foreground`, `text-muted-foreground`, `border-border`, `bg-primary text-primary-foreground`.540 **Never** use arbitrary hardcoded hex codes (`bg-[#0a0a0a]`).5412. **Dual-Theme Parity**:542 All blocks must look polished in both Light and Dark mode without contrast issues.5433. **Primitives Compatibility**:544 Supports both **Base UI** (`render` prop) and **Radix UI** (`asChild` prop).5454. **Motion Restraint**:546 Use purposeful spring micro-interactions (`motion/react`). Always respect `prefers-reduced-motion`.5475. **Interactive Link Polish**:548 Every `<a>` element must feature an explicit hover state (`hover:underline`, `hover:text-primary`).549 Never nest `<button>` inside `<a>` or vice-versa.