Download the PHP package ailuracode/bladcn without Composer
On this page you can find all versions of the php package ailuracode/bladcn. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ailuracode/bladcn
More information about ailuracode/bladcn
Files in ailuracode/bladcn
Package bladcn
Short Description CLI to add shadcn-style Blade components to Laravel projects
License MIT
Homepage https://github.com/ailuracode/bladcn-cli
Informations about the package bladcn
bladcn CLI
shadcn/ui-style CLI to install Blade + Alpine components in Laravel projects.
Copies components from bladcn-components (CSS, JS, Blade) and resolves dependencies from each dependencies.json.
Registry layout (bladcn-components)
The CLI package does not ship component assets; they live in bladcn-components (default ../bladcn-components).
Installation
Or clone this repo and use the binary directly:
Usage
With Artisan (recommended in Laravel)
Standalone binary
From your Laravel app root:
Configuration (bladcn.json)
The default registry points to bladcn-components. You can change it using any of these formats:
Local registry (development)
You can also set a relative path in registry:
How components are resolved
Resolution is declarative: the CLI reads each component's dependencies.json in the registry and persists installed components in resolved inside bladcn.json. It does not infer dependencies from Blade imports.
Registry lookup
Registry locates components under resources/views/components/ui/ (preferred) or components/ inside the configured registry. A component is either a folder (accordion/) or a single file (foo.blade.php).
dependencies.json manifest
Only folder components may include a manifest. ComponentManifest parses:
| Field | Purpose |
|---|---|
dependencies |
Other registry components installed first (transitive, depth-first) |
composer |
Packages passed to composer require when missing |
npm |
Documented for the host project (not installed automatically) |
css |
CSS files copied from the registry and imported into the main CSS file |
js |
JS files copied under resources/js/ and wired into bladcn.js when needed |
Same-group sub-components (e.g. accordion/trigger.blade.php) are not listed in dependencies; only external registry components are.
Install flow (bladcn add)
When you run bladcn add accordion, the CLI:
- Validates the component exists in the registry
- Builds an ordered install plan via
ComponentInstaller::resolveInstallPlan()(dependencies first) - Copies each component folder/file to
componentsPath(skipsdependencies.json) - Runs
composer requirefor aggregatedcomposerentries (--no-external-depsskips this) - Publishes
css/jsassets and updates imports inapp.css/bladcn.js - Merges newly installed names into
resolvedinbladcn.json
Use --no-deps to install only the requested component without transitive registry dependencies.
Remove flow (bladcn remove)
ComponentRemover uses resolved plus DependencyResolver to detect orphans: internal components, Composer packages, and CSS/JS assets that no remaining installed component still needs. Orphan removal can be skipped with --no-orphans.
Laravel project requirements
Copied components require the following in the host app (this CLI does not install them):
| Dependency | Purpose |
|---|---|
livewire/blaze |
@blaze directive |
mallardduck/blade-lucide-icons |
<x-ui.icon> |
@ailuracode/alpine-child |
Client-side as-child slot delegation |
resources/css/app.css |
Tailwind 4 + shadcn tokens |
resources/js/bladcn.js |
Alpine helpers (bladcnOnAlpine, scroll-area, copy button) |
resources/js/bladcn/carousel.js |
Embla carousel registration |
resources/views/partials/bladcn-boot.blade.php |
Layout hook before @stack('bladcn-scripts') |
Commands
| Artisan | Binary | Description |
|---|---|---|
bladcn:init |
bladcn init |
Create bladcn.json and publish base stubs |
bladcn:list |
bladcn list |
List registry components |
bladcn:add |
bladcn add |
Install components and dependencies |
bladcn:remove |
bladcn remove |
Remove components and orphan deps |
add options
| Option | Description |
|---|---|
--all |
Install every component from the registry |
--no-deps |
Skip internal dependencies |
--no-external-deps |
Skip automatic composer require |
--overwrite |
Overwrite existing components |
--dry-run |
Preview without copying |
remove options
| Option | Description |
|---|---|
--no-orphans |
Do not remove orphan internal dependencies |
--yes |
Remove orphans without prompting |
--dry-run |
Preview without deleting |
init options
| Option | Description |
|---|---|
--with-dark-mode |
CSS theme with .dark variables |
--css-file=app.css |
Main CSS file to import the theme into |
--theme-file=bladcn-theme.css |
Theme file name |
--skip-prompts |
Skip interactive prompts |
--skip-assets |
Only bladcn.json, no stubs |
--force |
Overwrite existing files |
Code quality
Aligned with laravel-starter-kit: Laravel Pint (strict preset), Larastan (max level + bleedingEdge), Rector with rector-laravel.
See AGENTS.md for architecture notes and agent conventions.
License
MIT. See LICENSE.
All versions of bladcn with dependencies
illuminate/console Version ^11.0|^12.0|^13.0
illuminate/support Version ^11.0|^12.0|^13.0
symfony/console Version ^7.0|^8.0