shadcn-lab

In-app playground to preview shadcn/ui components in your project. See what components you have — directly inside your app.

No Storybook. No config. Just a /playground page.

Why

shadcn/ui is code-first. Docs show components, but not your components, with your theme.

shadcn-lab adds a local playground so you can:

• visually browse components
• see variants and states
• build and tweak faster

Install

pnpx shadcn-lab

What it does

• Detects Next.js App Router (app/ or src/app)
• Adds /playground route
• Uses real shadcn components
• Disabled automatically in production
• Warns if required components are missing

Requirements

• Next.js (App Router)
• Tailwind CSS
• shadcn/ui installed (If components are missing, it will guide you to installation.)

Usage

Run dev server:

npm run dev

Open /playground route

http://localhost:3000/playground

Example

Philosophy

• Zero magic
• No config mutation
• No auto-installs
• Easy to delete

This is a developer utility, not a framework.

Current support

shadcn-lab currently includes a playground for:

• Button
• Input
• Accordion (v0.1.1)
• Alert (v0.1.2)
• Alert Dialog (v0.1.3)
• Avatar (v0.1.4)
• Badge (v0.1.5)
• Breadcrumb (v0.1.6)
• Card (v0.1.7)
• Tabs (v0.1.7)

More components are coming soon.

Contributing

This project is intentionally small and opinionated.

If you want to contribute:

• Add new playground sections for shadcn components
• Keep changes minimal and easy to remove
• Follow existing structure under templates/playground

No complex setup or tooling is expected.

Small, focused PRs are welcome.

Roadmap

• More components
• Better grouping
• Optional sections
• Registry support

Development notes

The apps/preview directory contains a local Next.js app used to preview and maintain the playground templates. It is for development only and is not published to npm.

Unofficial

This project is not affiliated with shadcn/ui. It simply follows the same philosophy.