PHPackages                             safi/laralcn-ui - 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. [Templating &amp; Views](/categories/templating)
4. /
5. safi/laralcn-ui

ActiveLibrary[Templating &amp; Views](/categories/templating)

safi/laralcn-ui
===============

LaralCN-UI: a shadcn-style copy-and-own Blade component installer for Laravel.

0.2.0(1mo ago)117MITBladePHP ^8.2CI passing

Since May 16Pushed 1mo agoCompare

[ Source](https://github.com/Abdulkader-Safi/LaralCN-UI)[ Packagist](https://packagist.org/packages/safi/laralcn-ui)[ Docs](https://github.com/Abdulkader-Safi/LaralCN-UI)[ RSS](/packages/safi-laralcn-ui/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (12)Versions (3)Used By (0)

LaralCN-UI
==========

[](#laralcn-ui)

A shadcn/ui-style **copy-and-own** component system for Laravel &amp; Blade.

LaralCN-UI is **not** a component library. You do not depend on a runtime package for the components. You pull individual components into your own project as plain `.blade.php` files that you fully own and can edit.

- **25 components + blocks.** Matched to current shadcn/ui (OKLCH theme, Tailwind v4 sizing/variants), including a full composable `sidebar` and the `sidebar-01` block.
- **Pure Blade + Tailwind v4.** Alpine.js only when interactivity is unavoidable. No React/Vue, no base UI primitive dependency.
- **Two channels.** Install via Artisan CLI, or copy from the website.
- **Yours to edit.** Components live in your source tree. No version coupling.
- **MIT licensed.**

Channel A: CLI
--------------

[](#channel-a-cli)

```
composer require --dev safi/laralcn-ui   # once
php artisan ui:init                      # one-time project setup
php artisan ui:add button                # per component
```

```
Delete
```

Commands: `ui:init`, `ui:add`, `ui:list`, `ui:diff`. The CLI is Laravel-only.

Channel B: copy from the website
--------------------------------

[](#channel-b-copy-from-the-website)

Every component has a docs page with a live preview and one-click copyable source. Copy the file into `resources/views/components/ui/`, copy the theme variables once, done. No CLI, no Composer. This is the supported path for plain-Blade and Statamic projects. Multi-file components (e.g. `breadcrumb`, `sidebar`) ship as a Blade namespace — the docs page lists every file with its target path.

Blocks
------

[](#blocks)

Blocks are ready-made, multi-component layouts you copy and own. The site's **Blocks** page (`/blocks`) shows each block with a live preview, the `ui:add` command for the components it composes, and its full source. The first block is **`sidebar-01`** — a collapsible application shell (icon mode, mobile off-canvas, workspace switcher, nav-user) built from `sidebar`, `breadcrumb`, `collapsible`, `dropdown-menu`, `avatar`, `separator`, `button`, and `skeleton`.

```
php artisan ui:add sidebar breadcrumb collapsible dropdown-menu avatar separator button skeleton
```

Then paste the block's `` composition into your layout. (An installable `ui:add sidebar-01` one-shot is planned — see `component-plan.md`.)

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

[](#requirements)

- Laravel app on Tailwind CSS **v4** (the default `laravel new` setup: CSS-first `@import "tailwindcss"`, `@tailwindcss/vite`, no `tailwind.config.js`).
- `gehrisandro/tailwind-merge-laravel` in the consuming project (so `class="px-8"` correctly overrides a component's built-in `px-4`). `ui:init` detects this and prints the install command.
- Alpine.js only for interactive components (Dialog, Dropdown, etc.).

Repository layout (monorepo)
----------------------------

[](#repository-layout-monorepo)

PathWhat`packages/blade-ui`the `safi/laralcn-ui` installer package + CLI`registry/`single source of truth: component JSON + sources`website/`Laravel docs/showcase app (dogfoods the components)`docs/``DECISIONS.md` (locked calls), `AUTHORING.md`Contributing
------------

[](#contributing)

Read `docs/AUTHORING.md` (the component standard) and `docs/DECISIONS.md` (the locked architectural calls) before proposing components.

License
-------

[](#license)

MIT © 2026 [AbdulKader Safi](https://abdulkadersafi.com)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance91

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~26 days

Total

2

Last Release

43d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c5c0510a49cdd55a56d75973cd9c8f34e4ecb8ae05d75b014481c9055292d60d?d=identicon)[Abdulkader-Safi](/maintainers/Abdulkader-Safi)

---

Top Contributors

[![Abdulkader-Safi](https://avatars.githubusercontent.com/u/53955839?v=4)](https://github.com/Abdulkader-Safi "Abdulkader-Safi (33 commits)")

---

Tags

laraveluicomponentsbladetailwindshadcn

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/safi-laralcn-ui/health.svg)

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

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M246](/packages/laravel-ai)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)[moonshine/moonshine

Laravel administration panel

1.3k253.1k86](/packages/moonshine-moonshine)[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.3k453.6k30](/packages/tightenco-jigsaw)[robsontenorio/mary

Gorgeous UI components for Livewire powered by daisyUI and Tailwind

1.5k570.6k23](/packages/robsontenorio-mary)[erag/laravel-lang-sync-inertia

A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications.

4925.3k](/packages/erag-laravel-lang-sync-inertia)

PHPackages © 2026

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