Skip to content
Back to search

shadcnspace

SkillWorks with Claude CodeGitHub

Production UI component library with MCP server integration, 100+ blocks, 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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/shadcnspace/shadcnspace with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/shadcnspace/shadcnspace'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shadcnspace--shadcnspace/badge.svg)](/listings/shadcnspace--shadcnspace)

HTML

<a href="/listings/shadcnspace--shadcnspace"><img src="/api/listings/shadcnspace--shadcnspace/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You can add components directly to the project and keep full ownership of the code.

Using the CLI

Install components, blocks, or templates using a CLI-based workflow that integrates with existing shadcn/ui projects.

npx shadcn@latest add @shadcn-space/button-06

This command adds the component source code directly to the project. You can edit, extend, or restructure it as needed.

**For More Components and Blocks Visit :** [**Shadcn Space**](https://shadcnspace.com)

Manual Usage

You can also copy components, blocks, or layouts directly from this repository.

- No build step required - All code is transparent and editable - Follows the docs.

This approach works well for teams that prefer manual control or selective adoption.

Explore more from documentation

- [**How to use Shadcn Cli**](https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 458 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: shadcnspace
  3. description: Production UI component library with MCP server integration, 100+ blocks, 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.
  4. license: MIT
  5. compatibility: Next.js 14+, React 19/18, Tailwind CSS v4/v3, Base UI, Radix UI, Shadcn CLI, Cursor, Claude Code, Windsurf, Lovable, Bolt
  6. metadata:
  7. author: "shadcnspace"
  8. website: "https://shadcnspace.com"
  9. registry: "https://shadcnspace.com/r"
  10. documentation: "https://shadcnspace.com/docs"
  11. mcp: "https://mcp.shadcnspace.com/mcp"
  12. github: "https://github.com/shadcnspace/shadcnspace"
  13. ---
  14. # ShadcnSpace — AI Agent Skill & Developer Guide
  15. [ShadcnSpace](https://shadcnspace.com) is the premier open-source distribution and registry of 100+ production-ready Shadcn UI blocks, 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.
  16. - **Website**: [https://shadcnspace.com](https://shadcnspace.com)
  17. - **Block Directory**: [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks)
  18. - **Component Directory**: [https://shadcnspace.com/components](https://shadcnspace.com/components)
  19. - **Full-Page Templates**: [https://shadcnspace.com/templates](https://shadcnspace.com/templates)
  20. - **Documentation**: [https://shadcnspace.com/docs](https://shadcnspace.com/docs)
  21. - **MCP Server**: `https://mcp.shadcnspace.com/mcp`
  22. - **GitHub**: [https://github.com/shadcnspace/shadcnspace](https://github.com/shadcnspace/shadcnspace)
  23. ---
  24. ## Prerequisites — Install the Official shadcn/ui Skill First
  25. 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.
  26. ```bash
  27. # npm
  28. npx skills add shadcn/ui
  29. # pnpm
  30. pnpm dlx skills add shadcn/ui
  31. # bun
  32. bunx skills add shadcn/ui
  33. # yarn
  34. yarn dlx skills add shadcn/ui
  35. ```
  36. 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.
  37. ### Why Both Skills Together?
  38. | Layer | Skill | What the AI Learns |
  39. |---|---|---|
  40. | **Foundation** | `shadcn/ui` official skill | Core components, theming, CLI, `components.json`, CSS variables, dark mode, Tailwind v3/v4 |
  41. | **Extension** | This `shadcnspace` skill | 100+ blocks, ShadcnSpace registry, Base UI vs Radix UI blocks, MCP server, full-page templates |
  42. 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.
  43. ---
  44. ## Quick Start — How to Use ShadcnSpace
  45. Follow these 4 simple steps to start using ShadcnSpace in any Next.js or React project:
  46. ### Step 1: Initialize Shadcn in Your Project
  47. If your project doesn't have Shadcn UI configured yet:
  48. ```bash
  49. # Initialize shadcn UI
  50. npx shadcn@latest init
  51. ```
  52. *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).*
  53. ---
  54. ### Step 2: Configure the Registry in `components.json`
  55. Add the official `@shadcn-space` registry to your project's `components.json` file:
  56. #### For Free Blocks & Components:
  57. ```json
  58. {
  59. "$schema": "https://ui.shadcn.com/schema.json",
  60. "style": "base-nova",
  61. "registries": {
  62. "@shadcn-space": "https://shadcnspace.com/r/{name}.json"
  63. }
  64. }
  65. ```
  66. #### For Pro Users (With License Key):
  67. ```json
  68. {
  69. "$schema": "https://ui.shadcn.com/schema.json",
  70. "style": "base-nova",
  71. "registries": {
  72. "@shadcn-space": {
  73. "url": "https://shadcnspace.com/r/{name}.json",
  74. "params": {
  75. "email": "${EMAIL}",
  76. "license_key": "${LICENSE_KEY}"
  77. }
  78. }
  79. }
  80. }
  81. ```
  82. *Add `EMAIL=your@email.com` and `LICENSE_KEY=your-key` into your `.env` or `.env.local` file.*
  83. ---
  84. ### Step 3: Install Blocks & Components
  85. Run the installation command using your package manager for either **Base UI** or **Radix UI**:
  86. ```bash
  87. # Base UI (Recommended default)
  88. npx shadcn@latest add @shadcn-space/hero-01
  89. # Radix UI
  90. npx shadcn@latest add @shadcn-space/radix/hero-01
  91. ```
  92. ---
  93. ### Step 4: Import and Use in Your Code
  94. Components are copied directly into your `src/components/shadcn-space/` folder with complete source code ownership:
  95. ```tsx
  96. import Hero01 from "@/components/shadcn-space/hero-01";
  97. export default function LandingPage() {
  98. return (
  99. <main>
  100. <Hero01 />
  101. </main>
  102. );
  103. }
  104. ```
  105. ---
  106. ## Base UI vs Radix UI — Complete Commands Guide
  107. ShadcnSpace provides **dual-variant support**: every block, component, and full page is maintained in both **Base UI** and **Radix UI** primitives.
  108. ### Understanding the Difference
  109. - **Base UI (Recommended)**: The modern foundation for shadcn UI. Uses a unified `@base-ui/react` package, explicit `render` props instead of `Slot`, and a separate `Positioner` component.
  110. - **Radix UI**: The classic headless foundation. Uses individual `@radix-ui/react-*` packages and the `asChild` prop with `Slot`.
  111. ### 1. Base UI Commands
  112. #### Via Registry Namespace (Recommended — Shadcn CLI v3)
  113. ```bash
  114. # Blocks & Components
  115. npx shadcn@latest add @shadcn-space/<item-name>
  116. # Examples:
  117. npx shadcn@latest add @shadcn-space/hero-01
  118. npx shadcn@latest add @shadcn-space/bento-grid-01
  119. npx shadcn@latest add @shadcn-space/button-06
  120. npx shadcn@latest add @shadcn-space/pricing-01
  121. npx shadcn@latest add @shadcn-space/sidebar-01
  122. # Full Pages:
  123. npx shadcn@latest add @shadcn-space/pages/<page-name>
  124. # Example:
  125. npx shadcn@latest add @shadcn-space/pages/landing-page-01
  126. ```
  127. #### Via Direct URL (Shadcn CLI v2 / Fallback)
  128. ```bash
  129. # Blocks & Components
  130. npx shadcn@latest add https://shadcnspace.com/r/<item-name>.json
  131. # Pages
  132. npx shadcn@latest add https://shadcnspace.com/r/pages/<page-name>.json
  133. ```
  134. ---
  135. ### 2. Radix UI Commands
  136. #### Via Registry Namespace (Recommended — Shadcn CLI v3)
  137. ```bash
  138. # Blocks & Components
  139. npx shadcn@latest add @shadcn-space/radix/<item-name>
  140. # Examples:
  141. npx shadcn@latest add @shadcn-space/radix/hero-01
  142. npx shadcn@latest add @shadcn-space/radix/bento-grid-01
  143. npx shadcn@latest add @shadcn-space/radix/button-06
  144. npx shadcn@latest add @shadcn-space/radix/pricing-01
  145. npx shadcn@latest add @shadcn-space/radix/sidebar-01
  146. # Full Pages:
  147. npx shadcn@latest add @shadcn-space/pages/radix/<page-name>
  148. # Example:
  149. npx shadcn@latest add @shadcn-space/pages/radix/landing-page-01
  150. ```
  151. #### Via Direct URL (Shadcn CLI v2 / Fallback)
  152. ```bash
  153. # Blocks & Components
  154. npx shadcn@latest add https://shadcnspace.com/r/radix/<item-name>.json
  155. # Pages
  156. npx shadcn@latest add https://shadcnspace.com/r/pages/radix/<page-name>.json
  157. ```
  158. ---
  159. ### 3. Package Manager Syntax
  160. You can run any ShadcnSpace install command across all major package runners:
  161. | Package Manager | Command Syntax |
  162. |---|---|
  163. | **npm** | `npx shadcn@latest add @shadcn-space/<name>` |
  164. | **pnpm** | `pnpm dlx shadcn@latest add @shadcn-space/<name>` |
  165. | **bun** | `bunx --bun shadcn@latest add @shadcn-space/<name>` |
  166. | **yarn** | `yarn dlx shadcn@latest add @shadcn-space/<name>` |
  167. ### 4. Advanced CLI Commands
  168. ```bash
  169. # Install multiple blocks in one command:
  170. npx shadcn@latest add @shadcn-space/navbar-01 @shadcn-space/hero-01 @shadcn-space/footer-01
  171. # Force overwrite existing files without confirmation prompts:
  172. npx shadcn@latest add @shadcn-space/hero-01 --overwrite
  173. ```
  174. ---
  175. ## Troubleshooting & Problem Solving
  176. If you encounter issues when installing or using ShadcnSpace, use these fixes:
  177. ### 1. Problem: "Block / Component Not Found"
  178. - **Cause**: The component slug is mistyped, or `@shadcn-space` registry is missing in `components.json`.
  179. - **Solution**:
  180. 1. Verify the exact block name at [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks).
  181. 2. Confirm your `components.json` has:
  182. ```json
  183. "registries": {
  184. "@shadcn-space": "https://shadcnspace.com/r/{name}.json"
  185. }
  186. ```
  187. 3. If installing a Radix UI component, make sure you prefix with `radix/`:
  188. `npx shadcn@latest add @shadcn-space/radix/<name>`.
  189. 4. If installing a page, ensure the prefix is `pages/`:
  190. `npx shadcn@latest add @shadcn-space/pages/<name>`.
  191. ### 2. Problem: "Access Denied / 401 Unauthorized / Missing Credentials"
  192. - **Cause**: Trying to install a Pro block without authentication.
  193. - **Solution**:
  194. 1. Add your credentials to your project's `.env` or `.env.local`:
  195. ```env
  196. EMAIL=your@email.com
  197. LICENSE_KEY=your-license-key
  198. ```
  199. 2. Ensure your `components.json` specifies `params` for `@shadcn-space`:
  200. ```json
  201. "registries": {
  202. "@shadcn-space": {
  203. "url": "https://shadcnspace.com/r/{name}.json",
  204. "params": {
  205. "email": "${EMAIL}",
  206. "license_key": "${LICENSE_KEY}"
  207. }
  208. }
  209. }
  210. ```
  211. 3. Re-run your terminal or command prompt so the environment variables take effect.
  212. ### 3. Problem: Primitives / TypeScript Type Mismatch (Base UI vs Radix UI)
  213. - **Cause**: Using a Radix UI block in a project that only has Base UI installed, or vice-versa.
  214. - **Symptoms**: `Module not found: Can't resolve '@radix-ui/react-...'` or `Cannot find module '@base-ui/react'`.
  215. - **Solution**:
  216. - 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`).
  217. - If your project uses Radix UI: install the Radix variant (`@shadcn-space/radix/<name>`). Ensure required `@radix-ui/react-*` packages are present.
  218. - To migrate an existing project from Radix to Base UI, follow the [Migration Guide](https://shadcnspace.com/docs/getting-started/migrate-to-baseui).
  219. ### 4. Problem: "File already exists" prompt or conflict
  220. - **Cause**: The component or an underlying dependency file was already installed.
  221. - **Solution**: Pass the `--overwrite` flag:
  222. ```bash
  223. npx shadcn@latest add @shadcn-space/hero-01 --overwrite
  224. ```
  225. ### 5. Problem: Broken Styling or Missing Colors
  226. - **Cause**: Missing semantic color tokens (`--background`, `--foreground`, `--primary`, `--border`, etc.) in `globals.css`.
  227. - **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.
  228. ### 6. Problem: `components.json` Not Found
  229. - **Cause**: The project hasn't been initialized with shadcn CLI yet.
  230. - **Solution**: Run `npx shadcn@latest init` first in the root of your project.
  231. ---
  232. ## Documentation & Help Directory
  233. When you need detailed documentation, guides, or assistance, visit these official documentation pages:
  234. | Guide / Resource | URL | What You'll Find |
  235. |---|---|---|
  236. | **Getting Started Introduction** | [https://shadcnspace.com/docs/getting-started/introduction](https://shadcnspace.com/docs/getting-started/introduction) | Overview, philosophy, and repository introduction |
  237. | **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 |
  238. | **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` |
  239. | **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 |
  240. | **Component Usage Guide** | [https://shadcnspace.com/docs/getting-started/component](https://shadcnspace.com/docs/getting-started/component) | UI primitives, buttons, dropdowns, dialogs, inputs |
  241. | **Blocks Guide** | [https://shadcnspace.com/docs/getting-started/blocks](https://shadcnspace.com/docs/getting-started/blocks) | Marketing, hero, pricing, testimonials, bento grids, and dashboards |
  242. | **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 |
  243. | **Interactive CLI Builder** | [https://shadcnspace.com/cli](https://shadcnspace.com/cli) | Custom visual command builder for styles, themes, and icons |
  244. | **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 |
  245. | **Interactive Blocks Gallery** | [https://shadcnspace.com/blocks](https://shadcnspace.com/blocks) | Visual live preview and copy code for all 100+ blocks |
  246. | **Components Catalog** | [https://shadcnspace.com/components](https://shadcnspace.com/components) | Micro-interactions, animated text, dock, marquee |
  247. | **Full Page Templates** | [https://shadcnspace.com/templates](https://shadcnspace.com/templates) | Complete production-ready page templates |
  248. | **GitHub Issues & Community** | [https://github.com/shadcnspace/shadcnspace/issues](https://github.com/shadcnspace/shadcnspace/issues) | Bug reports, feature requests, and community discussions |
  249. ---
  250. ## ShadcnSpace MCP Server Integration
  251. 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.
  252. ### Cursor Setup (`~/.cursor/mcp.json`)
  253. ```json
  254. {
  255. "mcpServers": {
  256. "shadcnspace": {
  257. "url": "https://mcp.shadcnspace.com/mcp",
  258. "headers": {
  259. "Authorization": "Bearer your@email.com:your-license-key"
  260. }
  261. }
  262. }
  263. }
  264. ```
  265. *(Free tier users can omit the `headers` field; free blocks install without authentication).*
  266. ### Windsurf Setup
  267. In **Windsurf Settings → MCP Servers**, add:
  268. * **Server URL**: `https://mcp.shadcnspace.com/mcp`
  269. * **Authorization**: `Bearer your@email.com:your-license-key`
  270. ### Claude Code Setup
  271. ```bash
  272. claude mcp add shadcnspace https://mcp.shadcnspace.com/mcp
  273. ```
  274. ### Lovable & Bolt Setup
  275. * **Server URL**: `https://mcp.shadcnspace.com/mcp`
  276. * **Transport**: `HTTP`
  277. * **Auth**: Bearer token `your@email.com:your-license-key`
  278. ### Available MCP Tools
  279. | Tool | Purpose |
  280. |---|---|
  281. | `searchBlocks` | Search blocks by keywords (e.g. `hero`, `pricing`, `stats`, `sidebar`) |
  282. | `listBlocks` | List all available blocks in ShadcnSpace |
  283. | `getBlockInstall` | Returns the exact CLI command to install a block (Base UI or Radix UI) |
  284. | `searchPages` | Search full-page templates |
  285. | `getPageInstall` | Returns the install command for a complete page |
  286. | `listInstalledBlocks` | Inspect blocks already installed in the current project |
  287. | `get_audit_checklist` | Returns accessibility, theming, and responsive design checklist |
  288. ---
  289. ## Agent Usage Patterns & Prompts
  290. When prompting an AI agent in Cursor, Claude Code, or Windsurf, use these structured patterns:
  291. ### Single Block Generation
  292. ```
  293. Add a high-converting hero section for my SaaS using ShadcnSpace Hero 01 (Base UI).
  294. ```
  295. ```
  296. Create a pricing section with monthly and annual toggle using ShadcnSpace Radix UI Pricing 01.
  297. ```
  298. ```
  299. Add an admin sidebar and stats cards using ShadcnSpace Dashboard blocks.
  300. ```
  301. ### Full Landing Page Composition (One-Pass)
  302. ```
  303. Build a complete SaaS landing page using ShadcnSpace blocks:
  304. - Navbar: Sticky glassmorphic navbar from ShadcnSpace
  305. - Hero: Hero 01 with interactive badge and video preview
  306. - Features: Bento Grid 01 with micro-animations
  307. - Social Proof: Testimonial Marquee from ShadcnSpace
  308. - Pricing: Pricing 01 with 3 tiers and billing toggle
  309. - CTA: CTA 01 with email capture form
  310. - Footer: Multi-column footer with site links and newsletter signup
  311. ```
  312. ---
  313. ## Block & Component Taxonomy
  314. Explore the full interactive gallery at **[https://shadcnspace.com/blocks](https://shadcnspace.com/blocks)**:
  315. ### 1. Marketing & SaaS Landing Pages
  316. - **[Hero Sections](https://shadcnspace.com/blocks/marketing/hero-section)**: Conversational, media-split, video-embed, and badge-accented heroes.
  317. - **[Bento Grids](https://shadcnspace.com/blocks/marketing/feature-section)**: Asymmetric feature grids with interactive cards, badges, and counters.
  318. - **[Feature Sections](https://shadcnspace.com/blocks/marketing/feature-section)**: Tabbed showcases, sticky scroll-stacking cards, and icon lists.
  319. - **[Pricing Sections](https://shadcnspace.com/blocks/marketing/pricing-section)**: Tier comparisons, annual discount toggles, and feature checklists.
  320. - **[Testimonials](https://shadcnspace.com/blocks/marketing/testimonials-section)**: Infinite review marquees, avatar groups, and quotes.
  321. - **[Navbar & Headers](https://shadcnspace.com/blocks/marketing/navbar-section)**: Sticky glassmorphism navbars, desktop drop-menus, mobile sheets.
  322. - **[Footers](https://shadcnspace.com/blocks/marketing/footer-section)**: Multi-column sitemaps, newsletter forms, social badges.
  323. - **[CTAs](https://shadcnspace.com/blocks/marketing/cta-section)**: Gradient cards, newsletter signups, quick trial buttons.
  324. - **[Logo Clouds](https://shadcnspace.com/blocks/marketing/logo-cloud)**: Infinite partner tickers and social proof badges.
  325. - **[FAQs](https://shadcnspace.com/blocks/marketing/faq-section)**: Accessible accordion FAQs with category filtering.
  326. ### 2. Dashboard UI & Admin Systems
  327. - **[Dashboard Shells](https://shadcnspace.com/blocks/dashboard-ui/dashboard-shell)**: Responsive master-detail shells with sidebars and sticky headers.
  328. - **[Sidebars](https://shadcnspace.com/blocks/dashboard-ui/sidebars)**: Collapsible multi-tier navigation with team switchers and user profiles.
  329. - **[Statistics & Metric Cards](https://shadcnspace.com/blocks/dashboard-ui/statistics-component)**: KPI cards with delta trends and sparklines.
  330. - **[Charts](https://shadcnspace.com/blocks/dashboard-ui/charts-component)**: Recharts and ApexCharts line, area, bar, and donut charts.
  331. - **[Data Tables](https://shadcnspace.com/blocks/dashboard-ui/tables)**: TanStack Table with fuzzy search, column sorting, pagination, and bulk actions.
  332. - **[Forms](https://shadcnspace.com/blocks/dashboard-ui/forms)**: React Hook Form + Zod with clean validation states.
  333. ### 3. Application Interfaces
  334. - **Chat & AI Interfaces**: Message scrollers, streaming text bubbles, input prompt bars with attachments.
  335. - **Kanban Boards**: Drag-and-drop task workflows with status tags.
  336. - **Notes & Documents**: Document tree sidebar with distraction-free editor layouts.
  337. - **Calendars & Scheduling**: Date range pickers and timeline views.
  338. ### 4. Authentication Flows
  339. - **[Login](https://shadcnspace.com/blocks/marketing/login)**: OAuth buttons, email/password validation, remembered sessions.
  340. - **[Register](https://shadcnspace.com/blocks/marketing/register)**: Step-by-step signup, password strength meters.
  341. - **[Forgot Password](https://shadcnspace.com/blocks/marketing/forgot-password)**: Password recovery with OTP input blocks.
  342. ### 5. Animated Interactive Components
  343. - **[Apple Dock](https://shadcnspace.com/components/apple-dock)**: Magnified dock inspired by macOS.
  344. - **[Marquee](https://shadcnspace.com/components/marquee)**: High-performance infinite scrolling marquee.
  345. - **[Orbiting Circles](https://shadcnspace.com/components/orbiting-circles)**: Smooth planetary orbit animations.
  346. - **[Animated Text](https://shadcnspace.com/components/animated-text)**: Shimmer, typing, blur-fade, and gradient text.
  347. ---
  348. ## Design System & Anti-Slop Rules
  349. 1. **Semantic Design Tokens**:
  350. Use CSS variables and semantic Tailwind classes:
  351. `bg-background`, `bg-card`, `text-foreground`, `text-muted-foreground`, `border-border`, `bg-primary text-primary-foreground`.
  352. **Never** use arbitrary hardcoded hex codes (`bg-[#0a0a0a]`).
  353. 2. **Dual-Theme Parity**:
  354. All blocks must look polished in both Light and Dark mode without contrast issues.
  355. 3. **Primitives Compatibility**:
  356. Supports both **Base UI** (`render` prop) and **Radix UI** (`asChild` prop).
  357. 4. **Motion Restraint**:
  358. Use purposeful spring micro-interactions (`motion/react`). Always respect `prefers-reduced-motion`.
  359. 5. **Interactive Link Polish**:
  360. Every `<a>` element must feature an explicit hover state (`hover:underline`, `hover:text-primary`).
  361. Never nest `<button>` inside `<a>` or vice-versa.
README.md · README · 226 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Free Shadcn UI Blocks and Components
  2. [**Shadcn Space**](https://shadcnspace.com) is an open-source shadcn/ui system built on Base UI primitives for modern React applications. It helps teams ship modern React apps faster through a curated collection of production-ready components, reusable blocks, templates, and dashboard layouts.
  3. <a href="https://shadcnspace.com">
  4. <img
  5. alt="Shadcn Space banner"
  6. width="1000"
  7. src="https://images.shadcnspace.com/assets/github-image.webp"
  8. >
  9. </a>
  10. <br/><br/>
  11. Built with consistent design patterns, predictable component behavior, and accessibility-first foundations. Shadcn Space delivers clean user interfaces with strong performance and long-term maintainability.
  12. Build websites, dashboards, SaaS products, admin panels, landing pages, and internal tools without relying on generic shadcn/ui components or rebuilding common UI patterns. Shadcn Space provides a structured, scalable UI foundation while maintaining full code ownership.
  13. <p>
  14. <a href="/LICENSE">
  15. <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License">
  16. </a>
  17. <a href="https://x.com/ShadcnSpace" target="_blank">
  18. <img alt="Twitter Follow" src="https://img.shields.io/twitter/follow/ShadcnSpace">
  19. </a>
  20. </p>
  21. ---
  22. ## What’s Included
  23. Shadcn Space provides a complete, system-level UI foundation built on shadcn/ui and Base UI.
  24. ### UI Components
  25. Production-ready components designed for real application logic:
  26. - Buttons, badges, alerts
  27. All components follow consistent APIs, predictable behavior, and accessible defaults.
  28. ### UI Blocks
  29. Composable blocks built from core components:
  30. - Hero and feature sections
  31. - Dashboard sections and widgets
  32. Blocks are structured for reuse across pages and projects.
  33. ### Templates and Dashboard Layouts
  34. Layouts designed for long-term use:
  35. - Dashboards UI Kits
  36. - Landing pages
  37. Layouts are cohesive, extensible, and suitable for production systems.
  38. ## Installation and Quick Start
  39. You can add components directly to the project and keep full ownership of the code.
  40. ### Using the CLI
  41. Install components, blocks, or templates using a CLI-based workflow that integrates with existing shadcn/ui projects.
  42. ```bash
  43. npx shadcn@latest add @shadcn-space/button-06
  44. ```
  45. This command adds the component source code directly to the project. You can edit, extend, or restructure it as needed.
  46. **For More Components and Blocks Visit :** [**Shadcn Space**](https://shadcnspace.com)
  47. ### Manual Usage
  48. You can also copy components, blocks, or layouts directly from this repository.
  49. - No build step required
  50. - All code is transparent and editable
  51. - Follows the docs.
  52. This approach works well for teams that prefer manual control or selective adoption.
  53. ### Explore more from documentation
  54. - [**How to use Shadcn Cli**](https://shadcnspace.com/docs/getting-started/how-to-use-shadcn-cli)
  55. ## Not a library — a component distribution
  56. Following the core philosophy of shadcn, **Shadcn Space is not an “install-from-npm” UI library**.
  57. Instead, it’s an **open-source distribution of components**:
  58. - Copy the source code directly
  59. - Modify styles and variants freely
  60. - Adjust logic to fit your app
  61. - ntegrate seamlessly with your existing stack
  62. There are **no hidden abstractions or runtime dependencies**.
  63. The code is yours to own, adapt, and evolve.
  64. This **open-code approach** gives you full confidence and flexibility — so your UI scales with your product, not against it.
  65. ## Why should I use Shadcn Space ?
  66. Shadcn Space builds on the core philosophy of shadcn/ui while focusing on what teams often need next: **more ready-to-use variants, richer examples, and complete UI blocks**. It provides a growing collection of components, blocks, and layouts designed around real product use cases, helping developers move beyond primitives and assemble interfaces faster.
  67. While preserving the copy-and-paste, open-code approach, Shadcn Space aims to offer a **more guided and practical experience**. By showcasing multiple variants, sensible defaults, and pre-built patterns, it reduces the cognitive load of starting from scratch — without taking away flexibility or control over the code.
  68. ## Features
  69. Built for **real production use**, every [Shadcn components](https://shadcnspace.com/components), block, and layout follows shadcn/ui conventions and Base UI foundations.
  70. - **Extraordinary design** :
  71. Clean layouts, balanced spacing, and consistent visual structure across all components, blocks, and templates.
  72. - **System-first architecture** :
  73. Components, blocks, templates, and dashboards are designed to work together with shared structure and conventions.
  74. - **Built on shadcn/ui and Base UI** :
  75. Base UI primitives ensure better interaction logic, accessibility, and predictable behavior.
  76. - **100+ Free components** :
  77. Tabs, Tooltip, Button, Accordion, Badge, Card, Calendar, Checkbox, Apple Dock, Authentication flows designed for real applications.
  78. - **51+ Reusable UI blocks and layout** :
  79. Pre-built sections for marketing pages, applications, and dashboards, optimized for reuse.
  80. - **3+ Templates and dashboard UI kits** :
  81. Cohesive layouts for SaaS products, admin panels, onboarding flows, and internal tools.
  82. - **Tailwind CSS with CVA** :
  83. Utility-first styling with controlled variants using Class Variance Authority.
  84. - **CLI-friendly workflow** :
  85. Add components and blocks using a shadcn-style CLI. Full code ownership by default.
  86. - **Motion support** :
  87. Framer Motion variants that enhance interaction without affecting structure or accessibility.
  88. - **No runtime dependencies** :
  89. No wrappers, no hidden abstractions, and no vendor lock-in. All code lives in the project.
  90. ## Documentation
  91. For comprehensive documentation, please visit [Shadcn Space](https://shadcnspace.com).
  92. ## Available Blocks
  93. Shadcn Space provides an open-source collection of copy-and-paste [Shadcn Blocks](https://shadcnspace.com/blocks) designed to accelerate your project development. Below is a summary of the available block categories:
  94. ### Blocks Examples
  95. <table>
  96. <tr>
  97. <td width="33.3333%" align="center">
  98. <a href="https://shadcnspace.com/blocks/marketing/hero-section">
  99. <img alt="Shadcnspace Avatar" src="https://images.shadcnspace.com/assets/blocks-images/marketing/hero-section.webp" />
  100. </a>
  101. </td>
  102. <td width="33.3333%" align="center">
  103. <a href="https://shadcnspace.com/blocks/marketing/team-section">
  104. <img alt="Shadcnspace Accordion" src="https://images.shadcnspace.com/assets/blocks-images/marketing/team-section.webp" />
  105. </a>
  106. </td>
  107. <td width="33.3333%" align="center">
  108. <a href="https://shadcnspace.com/blocks/marketing/cta-section">
  109. <img alt="Shadcnspace Tooltip" src="https://images.shadcnspace.com/assets/blocks-images/marketing/cta-section.webp" />
  110. </a>
  111. </td>
  112. </tr>
  113. <tr>
  114. <td width="33.3333%" align="center">Hero Section</td>
  115. <td width="33.3333%" align="center">Team Section</td>
  116. <td width="33.3333%" align="center">CTA Section</td>
  117. </tr>
  118. <tr>
  119. <td width="33.3333%" align="center">
  120. <a href="https://shadcnspace.com/blocks/marketing/about-us-section">
  121. <img alt="Shadcnspace Avatar" src="https://images.shadcnspace.com/assets/blocks-images/marketing/about-us-section.webp">
  122. </a>
  123. </td>
  124. <td width="33.3333%" align="center">
  125. <a href="https://shadcnspace.com/blocks/marketing/pricing-section">
  126. <img alt="Shadcnspace Accordion" src="https://images.shadcnspace.com/assets/blocks-images/marketing/pricing-section.webp">
  127. </a>
  128. </td>
  129. <td width="33.3333%" align="center">
  130. <a href="https://shadcnspace.com/blocks/marketing/testimonials-section">
  131. <img alt="Shadcnspace Tooltip" src="https://images.shadcnspace.com/assets/blocks-images/marketing/testimonial-section.webp">
  132. </a>
  133. </td>
  134. </tr>
  135. <tr>
  136. <td width="33.3333%" align="center">About Us Section</td>
  137. <td width="33.3333%" align="center">Pricing Section</td>
  138. <td width="33.3333%" align="center">Testimonials Section</td>
  139. </tr>
  140. </table>
  141. [Explore all blocks](https://shadcnspace.com/blocks)
  142. ## Community
  143. Join the Shadcn Space community to discuss the library, ask questions, and share your experiences:
  144. - [Follow us on Twitter](https://x.com/ShadcnSpace)
  145. <!-- - 🎮 [Join us on Discord](https://discord.com/invite/kBHkY7DekX) -->
  146. ## License ©
  147. - Licensed under [MIT](/LICENSE)
  148. ## Useful Links
  149. - [**Website**](https://shadcnspace.com)
  150. - [**Documentation**](https://shadcnspace.com/docs/getting-started/introduction)
  151. - [**Components**](https://shadcnspace.com/components)
  152. - [**UI Blocks**](https://shadcnspace.com/blocks)
  153. - [**Templates**](https://shadcnspace.com/templates)
  154. - [**Dashboard UI**](https://shadcnspace.com/blocks#dashboard-ui)
  155. - [**Free Figma UI Kits**](https://www.figma.com/design/MIjmxli91VLmJP1uWF5wWk/shadcnspace-figma-uikit-free?node-id=662-66322&p=f)
  156. - [**Issues & Feature Requests**](https://github.com/shadcnspace/shadcnspace/issues)
  157. - [**Roadmap**](https://github.com/orgs/shadcnspace/projects/1)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.