PHPackages                             wirecn/laravel-wirecn - 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 & Views](/categories/templating)
4. /
5. wirecn/laravel-wirecn

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

wirecn/laravel-wirecn
=====================

Laravel Blade UI (wirecn): components with Tailwind class merging via cn()

v1.0.3.16(1mo ago)636MITBladePHP ^8.3

Since Apr 28Pushed 1mo agoCompare

[ Source](https://github.com/brenersrosa/wirecn)[ Packagist](https://packagist.org/packages/wirecn/laravel-wirecn)[ RSS](/packages/wirecn-laravel-wirecn/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (4)Versions (20)Used By (0)

wirecn / laravel-wirecn
=======================

[](#wirecn--laravel-wirecn)

Blade UI components for Laravel with Tailwind-friendly class merging via **`cn()`** ([tailwind-merge-php](https://github.com/gehrisandro/tailwind-merge-php)) and Alpine.js behaviours shipped as publishable JavaScript stubs.

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

[](#requirements)

- PHP `^8.3`
- Laravel `^12` or `^13` (Illuminate View / Support)
- Tailwind CSS v4 (or compatible) with your design tokens (`bg-popover`, `text-muted-foreground`, etc.)

Install
-------

[](#install)

```
composer require wirecn/laravel-wirecn:^1.0
```

### `minimum-stability: stable` + repositório `path`

[](#minimum-stability-stable--repositório-path)

**Packagist:** a versão vem **só das tags Git** (`v1.0.0`, …). Não usamos o campo `"version"` no `composer.json` do pacote — evita o erro do Packagist *“tag does not match version in composer.json”* quando a tag e o campo divergem.

**Repositório `path`:** sem `"version"` no pacote, o Composer expõe normalmente `dev-main` (ou o nome do branch). Para satisfazer `^1.0` com `minimum-stability: stable`, podes usar alias no projecto consumidor, por exemplo: `"wirecn/laravel-wirecn": "dev-main as 1.0.0"` (ajusta o branch à tua cópia local).

Publish **views** (required for the default workflow — components live in your app):

```
php artisan vendor:publish --tag=wirecn-views
```

Publish **JavaScript** (Alpine primitives, optional chart/phosphor islands):

```
php artisan vendor:publish --tag=wirecn-js
```

Then import Alpine (and islands if you use them) from your Vite entry, for example:

```
import './wirecn/alpine-ui.js';
```

Ensure Tailwind scans published components:

```
// tailwind.config / @source in CSS — example
'./resources/views/components/wirecn/**/*.blade.php',
```

### NPM dependencies

[](#npm-dependencies)

Composer does **not** install these. After `vendor:publish --tag=wirecn-js`, stubs live under `resources/js/wirecn/`. Install packages in **your app** root (`package.json`).

#### Required if you import `alpine-ui.js`

[](#required-if-you-import-alpine-uijs)

Used directly by the published bundle:

PackageRole[`embla-carousel`](https://www.embla-carousel.com/)``[`@floating-ui/dom`](https://floating-ui.com/)Floating overlays (dropdowns, popovers, tooltips, command palette positioning, etc.)```
npm install embla-carousel @floating-ui/dom
```

#### Optional — Phosphor icons

[](#optional--phosphor-icons)

Needed when you render `` (and defaults like `` that delegate to it).

PackageRole`react`, `react-dom``phosphor-island.jsx` mounts icons with `createRoot`[`@phosphor-icons/react`](https://phosphoricons.com/)Icon modules; `phosphor-registry.jsx` uses `import.meta.glob` over `node_modules/@phosphor-icons/react/dist/csr/*.es.js` (path is relative to **`resources/js/wirecn/`** → your app’s `node_modules`)Vite: add [`@vitejs/plugin-react`](https://github.com/vitejs/vite-plugin-react) and ensure `.jsx` under `resources/js/wirecn/` is compiled (same React major as your app).

Example (run after DOM ready; call again after Turbo / Livewire navigations if icons are injected later):

```
import { initPhosphorIcons } from './wirecn/phosphor-island.jsx';

void initPhosphorIcons();
```

#### Optional — Charts

[](#optional--charts)

Needed for `` (`data-ui-chart` nodes).

PackageRole`react`, `react-dom`Same as above if not already installed[`recharts`](https://recharts.org/)Chart primitives in `chart-island.jsx````
import { initUiCharts } from './wirecn/chart-island.jsx';

initUiCharts();
```

#### Versions and licensing

[](#versions-and-licensing)

wirecn does not ship a `package.json` for your app: **pin versions** next to your Laravel / Vite / React stack. When upgrading wirecn, re-publish or diff stubs, then adjust npm ranges if builds fail.

Third-party docs: [Embla](https://www.embla-carousel.com/), [Floating UI](https://floating-ui.com/), [Phosphor](https://phosphoricons.com/), [Recharts](https://recharts.org/). You do not need to copy their APIs into this README—only install what you use and wire the init helpers above.

Usage
-----

[](#usage)

After publishing, use dot notation for nested components:

```

Save
...
```

`class` and other HTML attributes are forwarded where each stub uses `$attributes->class(cn(...))`.

Updates
-------

[](#updates)

LayerWhat updatesHow**PHP** (`cn()`, `Wirecn\Laravel\Support\UiIcon`, service provider)`composer update wirecn/laravel-wirecn`SemVer tags on Packagist.**Published Blade / JS**Files under `resources/views/components/wirecn/` and `resources/js/wirecn/`**Not** overwritten by Composer. For upstream template fixes, read **CHANGELOG**, then re-run `vendor:publish --tag=wirecn-views --force` (backup first if you customised) or merge diffs manually.Use [SemVer](https://semver.org/): patch for bugfixes, minor for backwards-compatible additions, major for breaking PHP or Blade contracts.

Packagist (public)
------------------

[](#packagist-public)

Submit this repository (or a split mirror with this package at the Git root) to [Packagist](https://packagist.org). During local development you can use a Composer **path** repository pointing at this directory.

License
-------

[](#license)

MIT

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance92

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 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 ~0 days

Total

19

Last Release

41d ago

### Community

Maintainers

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

---

Top Contributors

[![brenersrosa](https://avatars.githubusercontent.com/u/50274622?v=4)](https://github.com/brenersrosa "brenersrosa (39 commits)")

---

Tags

laraveluibladetailwindwirecn

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[moonshine/moonshine

Laravel administration panel

1.3k239.9k72](/packages/moonshine-moonshine)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

719160.4k12](/packages/tallstackui-tallstackui)[blade-ui-kit/blade-icons

A package to easily make use of icons in your Laravel Blade views.

2.5k39.5M381](/packages/blade-ui-kit-blade-icons)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9732.3M121](/packages/roots-acorn)[robsontenorio/mary

Gorgeous UI components for Livewire powered by daisyUI and Tailwind

1.5k531.0k21](/packages/robsontenorio-mary)

PHPackages © 2026

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