PHPackages                             bladecn/bladecn - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. bladecn/bladecn

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

bladecn/bladecn
===============

A Laravel UI component package

v0.8(4mo ago)24861[2 PRs](https://github.com/TharinduWijayarathna/BladeCN/pulls)MITBladePHP ^8.3CI passing

Since Nov 8Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/TharinduWijayarathna/BladeCN)[ Packagist](https://packagist.org/packages/bladecn/bladecn)[ Docs](https://github.com/bladecn/bladecn)[ GitHub Sponsors](https://github.com/:vendor_name)[ RSS](/packages/bladecn-bladecn/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (13)Versions (11)Used By (0)

BladeCN
=======

[](#bladecn)

A beautiful Laravel UI component library inspired by shadcn/ui, providing a complete set of components and starter templates for building modern web applications.

[![Latest Version on Packagist](https://camo.githubusercontent.com/cff6d0b441dd4704c4d36fa9cb8805bf8b2df974ec417d443a156fdc40914f08/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c616465636e2f626c616465636e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bladecn/bladecn)[![Total Downloads](https://camo.githubusercontent.com/a1904293dd9918b7b8cc3071622cd35d5c25d534b0d19d5b9d03848fd58f87a4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c616465636e2f626c616465636e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bladecn/bladecn)

Features
--------

[](#features)

- 🎨 **50+ Components** - Complete shadcn/ui component library for Laravel Blade
- 🔐 **Authentication System** - Pre-built login, registration, and password reset flows
- 📊 **Dashboard Templates** - Ready-to-use dashboard with stats, tables, and cards
- 👤 **Profile Management** - Complete user profile and account settings pages
- 📱 **Responsive Design** - Mobile-first, fully responsive components
- 🌙 **Dark Mode** - Built-in dark mode support across all components
- ⚡ **Easy Integration** - Simple Blade component syntax
- 🎯 **Type-Safe** - PHP component classes with comprehensive type hints

Installation
------------

[](#installation)

Install via Composer:

```
composer require bladecn/bladecn
```

Quick Start
-----------

[](#quick-start)

### 1. Run the Installer

[](#1-run-the-installer)

```
php artisan bladecn:install
```

This command publishes all necessary files to your application:

- Views (authentication, components, layouts)
- Component classes
- Authentication controllers and routes
- CSS and JavaScript assets
- Helper functions

### 2. Install Frontend Dependencies

[](#2-install-frontend-dependencies)

```
npm install tailwindcss @tailwindcss/vite tailwindcss-animate alpinejs @alpinejs/focus
npm run build
```

### 3. Update Autoloader

[](#3-update-autoloader)

```
composer dump-autoload
```

### 4. Start Building

[](#4-start-building)

Your application now includes:

- **Authentication Pages** - `/login`, `/register`, `/forgot-password`
- **Dashboard** - `/dashboard` with pre-built components
- **Profile** - `/profile` for account management

Usage
-----

[](#usage)

### Authentication Layout

[](#authentication-layout)

```

        @csrf
        Email

        Password

        Sign in

```

### Application Layout

[](#application-layout)

```

        Dashboard

                Welcome

                Your content here

```

### Components

[](#components)

All UI components are namespaced under `x-ui`:

```

Default
Outline
Delete

        Title

    Content

            Name

            John Doe

        Open

            Confirm Action

        Are you sure?

```

Component Categories
--------------------

[](#component-categories)

- **Form Components** - Input, Textarea, Checkbox, Radio, Select, Label
- **Buttons** - Multiple variants and sizes
- **Cards** - Header, content, footer sections
- **Dialogs &amp; Modals** - Dialog, Sheet components
- **Navigation** - Breadcrumbs, Dropdown menus
- **Data Display** - Tables, Badges, Avatars, Progress bars
- **Layout** - Separators, Grid systems
- **Feedback** - Tooltips, Spinners, Error messages

For a complete component reference, visit the [documentation](https://github.com/bladecn/bladecn).

Customization
-------------

[](#customization)

### Theming

[](#theming)

BladeCN uses CSS variables for theming. Customize colors in your `resources/css/app.css`:

```
:root {
    --background: 0 0% 100%;
    --foreground: 222.2 84% 4.9%;
    --primary: 222.2 47.4% 11.2%;
    /* Customize other variables */
}
```

### Configuration

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag="bladecn-config"
```

Requirements
------------

[](#requirements)

- PHP 8.3 or higher
- Laravel 10.x, 11.x, or 12.x
- Tailwind CSS 4.x

Documentation
-------------

[](#documentation)

For detailed documentation, component examples, and guides, visit [bladecn.dev](https://github.com/bladecn/bladecn).

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

License
-------

[](#license)

BladeCN is open-sourced software licensed under the [MIT license](LICENSE.md).

Credits
-------

[](#credits)

BladeCN is inspired by [shadcn/ui](https://ui.shadcn.com) and built for the Laravel ecosystem.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance81

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

9

Last Release

149d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2d26e7f2ae7faffa153b86b7adac4068b066b16c544a92e5e3429c39ce92ef1?d=identicon)[tharindu](/maintainers/tharindu)

---

Top Contributors

[![TharinduWijayarathna](https://avatars.githubusercontent.com/u/81649942?v=4)](https://github.com/TharinduWijayarathna "TharinduWijayarathna (54 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laravelbladecn

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bladecn-bladecn/health.svg)

```
[![Health](https://phpackages.com/badges/bladecn-bladecn/health.svg)](https://phpackages.com/packages/bladecn-bladecn)
```

###  Alternatives

[spatie/laravel-data

Create unified resources and data transfer objects

1.8k28.9M627](/packages/spatie-laravel-data)[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[hirethunk/verbs

An event sourcing package that feels nice.

513162.9k6](/packages/hirethunk-verbs)[worksome/exchange

Check Exchange Rates for any currency in Laravel.

123544.7k](/packages/worksome-exchange)[ralphjsmit/livewire-urls

Get the previous and current url in Livewire.

82270.3k4](/packages/ralphjsmit-livewire-urls)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
