README

A Laravel Blade port of shadcn/ui. Beautiful, accessible, and customizable components built with Laravel Blade and Tailwind CSS.

About

shadcn-blade/ui brings the popular shadcn/ui component library to Laravel Blade. This is not a component library in the traditional sense - you don't install it as a dependency. Instead, you pick the components you need and add them directly to your project.

The components are:

• Built with Laravel Blade and Tailwind CSS
• Fully customizable and accessible
• Styled with a consistent design system
• Easy to integrate into any Laravel project

Installation

Install the package via composer:

composer require shadcn-blade/ui

Initialize shadcn-blade in your project:

php artisan shadcn:init

This will:

• Create a components.json configuration file
• Set up Tailwind v4 with theme variables
• Allow you to choose a base color scheme (neutral, zinc, slate, stone, gray)
• Create the component directory structure

Usage

Add components to your project:

# Add individual components
php artisan shadcn:add button
php artisan shadcn:add input

# Components are copied to resources/views/components/ui/
# You own the code and can customize freely

Use components in your Blade views:

<x-ui.button variant="default">Click me</x-ui.button>
<x-ui.input type="email" placeholder="Email" />
<x-ui.badge variant="destructive">New</x-ui.badge>

Color Schemes

Choose from 5 base color schemes during initialization:

• neutral - Pure grayscale
• zinc - Neutral with minimal saturation
• slate - Cool blue-gray tones
• stone - Warm gray with brown undertones
• gray - Balanced neutral gray

To change the color scheme later:

php artisan shadcn:init --force

Components

Legend:

• ✅ Complete & Available
• 🚧 In Progress
• ⏳ Planned

Component Status

Total: 58 components (16 complete, 42 planned)

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• ihxnnxs
• Inspired by shadcn/ui

License

The MIT License (MIT). Please see License File for more information.