#What is Alpine Registry?

Alpine Registry is the official, reference implementation of a custom shadcn/ui registry built by shadcn to show developers exactly how to create, distribute, and consume reusable UI components, blocks, and utilities across projects. It serves both as a learning resource and a ready-to-use starter pack for React developers already working with shadcn/ui who want polished, production-grade patterns without reinventing distribution mechanics. Built with Next.js (App Router), TypeScript, Tailwind CSS, and the official registry schema, it's ideal for use-cases like setting up team/internal component libraries, sharing public extensions, prototyping features with booking forms or listing grids, or simply understanding how the entire shadcn registry ecosystem works under the hood—empowering you to own and scale your design system with confidence.

#Features ⚡

• shadcn CLI Ready: Add components with simple commands like npx shadcn add @alpine/main-nav after adding the registry to components.json

• JSON-First Architecture: Every component lives as a clean .json file (e.g., /r/logo.json) defining name, files, dependencies, and source code

• Beautiful Showcase: Modern preview site at alpine-registry.vercel.app with component cards, usage instructions, and "Open in v0" buttons

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

• Practical Patterns: Real-world examples including responsive navigation, booking/search forms, listing cards/grids, and combined sections

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

#Pros ✅

• Official reference from shadcn—highest quality learning material and blueprint available

• Makes sharing and maintaining UI code across teams or projects effortless

• v0.dev links supercharge workflow with instant editable previews

• Free and open-source nature encourages forking for private use or contributions

• Clean, minimal patterns that integrate perfectly with existing shadcn setups

#Cons ⚠️

• Serves primarily as an educational example—collection is intentionally small and focused

• Requires an existing shadcn/ui project for meaningful usage

• Basic styling relies on shadcn defaults—additional theming needed for unique brands

#Included Components - Templates

Alpine Registry provides a thoughtful starter set of components designed to demonstrate real patterns: @alpine/logo for brand headers; @alpine/main-nav for responsive navigation with auth/social links; @alpine/booking-form for location/date picker search flows; @alpine/contact-form for name/email/message submissions; @alpine/example-listing-card for individual item displays; @alpine/example-listing-grid for multi-item layouts; @alpine/example-section-listing for heading + grid combinations; @alpine/example-section-booking for integrated form + content blocks—all with JSON configs, live previews, and ready-to-install code.

#Pricing 💸

Alpine Registry is completely free and open-source under the MIT license (aligned with shadcn/ui), with no tiers, subscriptions, or costs—use the registry, components, showcase, and source code unlimited for personal, team, internal, or commercial projects.

#Integrations 🧰

Alpine Registry works natively with shadcn/ui CLI and component system; Tailwind CSS for styling; Next.js (App Router) for the showcase site; v0.dev for interactive previews and generation; plus any React/TypeScript project supporting shadcn registries—deployable on Vercel or similar platforms.