#What is WDS Shadcn Registry?

WDS Shadcn Registry is the official reference implementation and learning resource created by Kyle Cook of Web Dev Simplified to teach developers how to build, distribute, and consume custom shadcn/ui components at scale. It serves as both an educational showcase and a ready-to-use starter kit for React developers using shadcn/ui who want clean, well-documented patterns for common UI needs without reinventing the registry wheel. Built with Next.js (App Router), TypeScript, Tailwind CSS, and the official shadcn registry schema, it's ideal for use-cases like setting up team component libraries, sharing public extensions, prototyping features with navbars, forms, cards, or sections, or simply mastering how custom registries work — empowering you to create consistent, maintainable, and shareable UI systems with confidence.

#Features ⚡

• shadcn CLI Ready: Install components with commands like npx shadcn add @wds/main-nav after registry configuration

• JSON-First Design: Each component defined in clean .json files (e.g., /r/main-nav.json) with name, files, dependencies, and full source code

• Beautiful Showcase Site: Modern preview pages with interactive demos, usage examples, props tables, and "Open in v0" links

• v0.dev Integration: One-click previews and AI-assisted code generation for rapid testing and customization

• Real-World Starter Patterns: Responsive navbar with auth, contact/booking forms, listing cards, grids, and combined sections

• Open-Source Learning Template: Complete GitHub repo you can fork instantly to build your own registry

#Pros ✅

• Official-quality example directly from Web Dev Simplified — the best educational resource for shadcn registries

• Makes learning and implementing custom registries simple, clear, and hands-on

• v0.dev integration supercharges prototyping and experimentation

• Free and open-source — perfect for both learning and real-world team use

• Clean, well-structured patterns that integrate flawlessly with any shadcn project

#Cons ⚠️

• Primarily an educational example — component collection is intentionally small and focused on teaching

• Requires an existing shadcn/ui setup to get real value

• Basic shadcn styling — needs theming for unique brand aesthetics

#Included Components - Templates

WDS Shadcn Registry provides a solid starter set of practical components: @wds/logo for brand headers; @wds/main-nav for responsive navigation with auth/social options; @wds/booking-form for location/date search flows; @wds/contact-form for name/email/message; @wds/example-listing-card for item displays; @wds/example-listing-grid for multi-item layouts; @wds/example-section-listing for heading + grid; @wds/example-section-booking for form + content blocks — all with JSON configs, live previews, and registry-ready code.

#Pricing 💸

WDS Shadcn Registry is completely free and open-source (MIT-aligned with shadcn/ui) — no tiers, subscriptions, or costs. Use the registry, components, showcase, and source code unlimited for personal, team, internal, or commercial purposes.

#Integrations 🧰

WDS Shadcn Registry works natively with shadcn/ui CLI & primitives; Tailwind CSS for styling; Next.js (App Router) for the showcase; v0.dev for previews/code generation; plus any React/TypeScript project supporting shadcn registries — deployable on Netlify, Vercel, or similar.