Skip to content
Bladewell

Laravel Blade components you install and own.

A free Laravel UI kit of Blade and Tailwind components, MIT licensed. One command copies only the ones you need into your app, to edit like your own code. No Livewire or Alpine needed, and they work inside Livewire too.

Build a hotel booking form with Bladewell components (https://www.bladewellui.com/llms.txt): guest name, the stay as a date range, a guest count with − and + buttons, a room select, and a total that updates when the dates or room change.

More prompts, and connecting your agent: For AI agents.

Source on GitHub · MIT licensed · Laravel 12 and 13, PHP 8.3+, Tailwind CSS 4.1+ · Changelog

Standard room
Deluxe room
Suite

1 night, Deluxe room

Total: $189

Built from <x-widget.text-input>, <x-widget.date-range-picker>, <x-widget.number>, <x-widget.select>, <x-widget.price-roll> and <x-widget.button>.

The booking form's code

The Blade for the form, and the JavaScript that works out its total. Add the components with the command beside it.

Blade
@php($rates = ['standard' => 129, 'deluxe' => 189, 'suite' => 320])
{{-- data-booking: booking.js works out the total when the dates or the room change. --}}
<form data-booking data-theme="light" data-rates="{{ json_encode($rates) }}"
    class="border-ink text-foreground bg-surface flex flex-col gap-5 rounded-[14px] border p-6 font-sans shadow-[8px_8px_0_0_var(--color-ink)] sm:p-8">
    <x-widget.text-input name="guest" label="Guest name" placeholder="Heisenberg Walter" autocomplete="off" />
    <x-widget.date-range-picker name="stay" label="Stay" min="today" :max="false" :months="1" />
    <x-widget.number name="guests" label="Guests" value="2" :decimals="0" min="1" max="4" stepper />
    <x-widget.select name="room" label="Room" value="deluxe" :options="['standard' => 'Standard room', 'deluxe' => 'Deluxe room', 'suite' => 'Suite']" />

    <div class="border-line flex flex-wrap items-end justify-between gap-4 border-t pt-5">
        <div>
            <p data-booking-summary class="text-foreground/60 text-sm">1 night, Deluxe room</p>
            <x-widget.price-roll id="booking-total" :value="$rates['deluxe']" currency="USD" locale="en-US" :decimals="0" label="Total" live class="text-3xl font-semibold" />
        </div>
        <x-widget.button type="submit">Check availability</x-widget.button>
    </div>
</form>

Install in three steps

For Laravel 12 and 13 with Vite and Tailwind CSS 4.1 or later, which new Laravel apps have out of the box.

Requirements and the full installation guide →

Starting a new app?

Use the starter kit

  • Laravel 13 with Bladewell installed
  • Light and dark theme, error pages, strict CSP
  • Laravel Boost and the MCP server set up for agents
  • Plain Blade: no React, Vue or Alpine to remove

Needs PHP 8.3+, Composer and Node.js 20.19+.

Terminal
composer create-project bladewell/starter-kit my-app
cd my-app
npm install && npm run build
Installation guide and requirements →
  1. Require the package

    It only does the copying, so it can stay a dev dependency. Your app never needs it at runtime.

    Terminal
    composer require --dev bladewell/bladewell
  2. Add the components you need

    Name the components, or run it with no names to pick from a list. It copies each one with what it depends on into your app, and adds the JS and CSS imports. Later, the same command updates them and leaves your own edits alone. How updates work.

    Terminal
    php artisan bladewell:add datepicker table
  3. Build your assets and use them

    Then write the tag like any other Blade component.

    Terminal, then Blade
    npm run build
    
    <x-widget.datepicker name="start_date" label="Start date" />

Works with Livewire

Not needed, but supported: every component is checked in a browser inside Livewire 3 and 4 components.

  • Form controls bind with wire:model, no name needed, and show the property's value and its validation errors after every render.
  • What someone did stays as they left it through a render: an open modal or menu, a panel they opened, a running stopwatch, files they picked.
  • The component shows toasts and opens or closes modals with $this->dispatch().
  • Components added by a render or by wire:navigate set themselves up, with nothing to call. Each one's page has a Livewire example under Usage.
Blade, then PHP
<form wire:submit="save">
    <x-widget.text-input label="Email" type="email" wire:model="email" />
    <x-widget.datepicker label="Start date" wire:model.live="start" />
    <x-widget.button type="submit">Save</x-widget.button>
</form>

// In the component, once it's saved
$this->dispatch('toast', type: 'success', message: 'Saved.');

Ready for AI agents

Agents get the same catalogue in a form they can read. Each component's entry has its install command, props, working examples and full source, so an agent can add a component or write it in by hand.

/llms.txt
An index of every component, for agents that follow the llms.txt convention.
/r/index.json
Every component, with a link to its full entry.
/r/datepicker.json
One component's full entry: install command, props, examples and source.
php artisan bladewell:list --json
The same catalogue offline, from the installed package.
php artisan bladewell:mcp
An MCP server in your app: the catalogue, what this app has installed and edited, and installing with a dry run first.
Connect your agent, with prompts to start from →

Questions

Is Bladewell the same as laravel/ui?
No. laravel/ui is the Laravel team's older package that scaffolds Bootstrap, Vue or React login pages. Bladewell is a separate, independent project: a catalogue of Blade and Tailwind CSS v4 components that one Artisan command copies into your app.
How is it different from a starter kit or a component package?
A starter kit sets up a new app once. A component package stays installed and you call its components. Bladewell copies each component's Blade, JavaScript and CSS into your existing app, so you can edit them like your own code, and it needs no Livewire or Alpine.
Does wire:model work on Bladewell components?
Yes, directly on the component, with no events or listeners to write: <x-widget.select wire:model.live="country" />. The form controls (inputs, select, date and time pickers, tags, file upload and the rest) show the property's value after every render, a value set in PHP included, and its validation errors. A component opens a modal or shows a toast with $this->dispatch(). Every component is checked in a browser inside Livewire 3 and 4.
Do I need wire:ignore to use Bladewell in Livewire?
No. The components already shield the parts their scripts build, so they keep what the person did through every render: an open modal, a sorted table, a running timer. Wrapping a form control in wire:ignore would stop it showing values set in PHP and validation errors. The one exception is a progress bar you drive from JavaScript with progress.set().
What are the limits of Bladewell in Livewire?
A few: files you have edited are merged by hand from bladewell:diff; the pickers, select and similar controls take their value from PHP or wire:model, not from Alpine or your own script; a captcha should be sent with wire:submit; and it needs Blade with Tailwind CSS v4. The Livewire guide at https://www.bladewellui.com/guides/livewire-blade-components lists them with examples.
Do copied components still get updates?
Yes. After composer update, php artisan bladewell:add --installed puts the new version into every file you haven't edited and lists the ones you have; bladewell:diff shows what those would miss. bladewell.lock keeps track of which is which, so your edits are only overwritten if you pass --force.
Does my app need Bladewell at runtime?
No. The package only does the copying, so it can stay a dev dependency. Once a component is copied in, it runs without it.
Is it free?
Yes. Bladewell is open source and MIT licensed.

Free, and staying free

Bladewell is MIT licensed and built in spare time. If a component saved you an afternoon, or it's in an app your company runs, sponsoring it on GitHub pays for new components, fixes and keeping up with Laravel and Tailwind releases. A one-off coffee helps too.