Changelog
Notable changes to bladewell/bladewell, by widget. The format follows Keep a Changelog, and versions follow Semantic Versioning.
Updating
A release changes nothing in your app until you run php artisan bladewell:add --installed. It updates the files you haven't edited and lists the ones you have; php artisan bladewell:diff shows what those would miss.
Component names, props and their values, data-* hooks, JS exports, the bladewell:* commands and flags, and config keys are only ever added to, never renamed or removed. A release can still reject input that never worked (a mistyped value that was ignored now throws); those changes are under Changed.
Unreleased
1.5.5 - 2026-11-20
Added
- toast: "Dismiss all" above the stack while two or more toasts are up (three on a phone, where its row takes room and two are quickly swiped away); its text is the
dismiss-all-labelprop. Focus goes back where it was. - toast: an action button, like Undo:
toast.success('Invoice deleted.', { action: { label: 'Undo', onClick } }). A toast with one stays until it's used or dismissed, is never merged with another, and is read out with "Actions available". - toast: each toast is marked
data-toast-item. - toast: on a touch screen, a toast swipes away sideways, either way: past a third of its width or on a flick. A shorter swipe springs it back, up and down still scroll the stack, and its time holds while it's in the finger.
Changed
- theme: the light theme's warning colour is amber (
#b54708) instead of yellow, so warning dots, borders, icons and bar segments can be seen: 5.4:1 on white, where the yellow was 1.3:1. The dark theme keeps its yellow. If you set--color-warningyourself, nothing changes for you. - file-upload: sizes are written as the app's locale writes numbers ("2,5 MB" in German), in the hint, the file list and the too-big message, where the intl extension is installed. Large ones are grouped ("1,000 MB").
UploadLimits::size()takes an optional locale. - toast: the layout snippet now sets
:alert-auto-close="false", so errors and warnings stay until they're dismissed. The default is unchanged: add it to your layout to get the same. - toast: the same toast shown again while it's still up (same kind, title and message) no longer stacks a copy: the one showing counts it (×3), comes back to the top, starts its time again and is read out again. Loading toasts are left as they are.
toast.success()and the others return the id of the toast that showed it;merge: falsealways gives a toast of its own.
Fixed
- toast: past what fits on screen, the stack scrolls; the toasts were squeezed shorter instead, cutting off their messages.
- toast: the same toast shown twice at once is read out once, not twice in a row.
- toast: flashed messages show without JavaScript too, plainly, where the toasts would be.
- toast: flashed messages show after Turbo and htmx page swaps, not only after a full load or Livewire's
wire:navigate. - toast: on a touch screen, Dismiss all and an action button take a finger from 44px, as the close button does.
1.5.4 - 2026-11-20
Added
- field:
composing(event)export, true while an input method (Chinese, Japanese, Korean…) is composing. - otp:
required-messageprop, shown when a required code is submitted with boxes left empty. - chat:
data-chat-error-livein the composer, the live region that reads out a message the server turned away. - toast:
alert-auto-closeprop, how long error and warning toasts stay;falsekeeps them until dismissed. Unset, they followauto-closeas before. - image-cropper: move left, right, up and down buttons (
data-image-cropper-action="pan-left"and so on, named bypan-left-labeland the like), so the crop can be moved without dragging, as the arrow keys move it. - time-picker:
variant="native", the browser's own time field, which opens the phone's time picker on a touch screen.
Changed
- clock: dates follow the locale's own order and words, so in English they now read "Sunday, September 27" (en_GB: "Sunday 27 September"). AM/PM comes from ICU too, with a narrow no-break space before it.
- command: a click on the dimmed area closes the palette only when the press started there as well, as the modal already did.
- tabs: closed panels are
hidden="until-found"and out of the Tab order (tabindex="-1"). If your CSS keeps closed panels laid out (stacked in one grid cell, say), addcontent-visibility: visibleto that rule.
Fixed
- all widgets: keyboard focus shows in Windows High Contrast (forced colours), where the focus ring used to vanish. The rule is in
base.css. - switch, radio, tabs, progress, stepper, datepicker, date-range-picker, calendar, color-picker: the on, checked, open, done, chosen and today states stay visible in Windows High Contrast.
- phone, select, search, tags: Enter that confirms characters in an input method no longer picks a country, an option or a suggestion, or adds a tag. Tags already handled this in Chrome and now does in Safari too.
- table: the scrollbars drawn over a table that scrolls inside itself are easier to see.
- tooltip, tooltip-cursor: a tooltip that only repeats its element's name (an icon button labelled Edit, with Edit as its tooltip) is no longer read out twice.
- otp: a required code can't be submitted with boxes left empty, and screen readers hear that it's required.
- progress: with reduced motion, an indeterminate bar or ring slows down instead of stopping on what looked like a value.
- table: tabbing upwards through a table that scrolls inside itself no longer hides the focused row under the header.
- pagination: the previous, next, first and last arrows point the right way in a right-to-left page.
- tabs: a disabled link tab no longer goes to its page when clicked.
- sidebar-layout: on a narrow screen, the open menu and panel are announced as dialogs, and a Livewire render keeps them so.
- chat: a message the server turns away is read out, and focus stays in the chat when Load older messages or Retry goes.
- file-upload: each upload's progress is a progress bar screen readers can follow.
- kanban, calendar: lists stay lists for VoiceOver in Safari, so a kanban column's card count is heard again.
- kanban: a radio in a card being dragged no longer unticks the card's own.
- number, phone: your own
autocompleteandinputmodereplace the widget's, instead of being ignored next to them. - modal: a modal opened again starts with no return value, so an Esc doesn't report the last button again; a locked modal also asks the browser to ignore Esc and the back gesture.
- command: a text selection dragged out of the search box no longer closes the palette, and the page behind no longer scrolls while it's open.
- clock: the date and AM/PM are written in the app's locale, in its own order and words (Sonntag, 27. September; 11月19日星期四), on the first frame and as it ticks. An analog clock's time is read out the locale's way too (午後5:41).
- otp, select, tags, datepicker, date-range-picker, time-picker: a required field that is also readonly no longer stops its form, as a browser doesn't for a readonly input.
- toast, alert, chat: messages are read out with
ariaNotify()where the browser has it, so the first one is never missed; the live regions still say them elsewhere. - sortable, kanban: a moved item keeps its focus, and a dragged one its pointer, where the browser can move elements without taking them out of the page (
moveBefore()). - price-roll: a new value arriving mid-roll no longer makes the digits still rolling jump.
- tabs, tree: find in page reaches the text in closed tab panels and branches (
hidden="until-found"), and opens the tab or branch it found it in. - accordion: an item opened by find in page or a link to something in it closes the others in its group, as a click does.
- pagination: counts are grouped as the app's locale groups them (12.345 in German), where the intl extension is installed.
- pagination, tree, table: Load more, an item's children and a table's next rows give up after 20 seconds with their error, instead of staying busy for good when the server never answers.
- captcha: the basic example plays the code aloud too, and the docs say to give an audio version with every image.
- otp, verification-code: the docs recommend the verification code for codes sent by text or email.
1.5.3 - 2026-11-15
Changed
- table: the selection bar stays in place, with its buttons disabled until a row is ticked, so ticking a row no longer shifts the rows.
Fixed
- alert: dismissing one no longer makes the content below jump.
- button: secondary and tertiary no longer flicker on hover, and the press feels smoother.
- command, pagination: the command palette and the pagination drawer's backdrop fade in and out, as a modal does.
- select: the open list follows the field when picked chips wrap onto a new line.
- select, datepicker, date-range-picker, time-picker, phone, search, table: popups open and close smoothly, as the dropdown does.
- tags, select: chips ease in and out as they're added and removed.
- tooltip-cursor: fades in, as the tooltip does.
- tree: nodes open and close smoothly.
1.5.2 - 2026-11-13
Added
- tags:
requiredstops an empty submit in the browser, with the field's own error style and focus in the box, as select and the pickers do. The message is the newrequired-messageprop.
Fixed
- datepicker, date-range-picker: the calendar closes when Tab moves focus out of it.
- dropdown: type-ahead stays on the focused item when it already matches the letter; pressing the letter again moves on.
- file-upload: the direct-upload route in Usage checks the file type on the server and stores on the private
localdisk. - image-cropper: lets go of each crop's memory as soon as it's cut, so picking several large photos on a phone no longer reloads the tab.
- pagination, table: the extra Apply button only shows when JavaScript is off.
- phone: resetting the form puts the country back along with the number.
- popover: a popover stays in place, and closes when its trigger scrolls away, after a popover opened inside it closes.
- select: follows a Livewire render that changes its search address,
multipleordisplay, or draws its chips and clear button again. - select, search, time-picker, phone: a list that can't fit beside its field, with the on-screen keyboard up, stays on screen.
- sortable: a list with another list inside one of its items submits only its own items' order, from the start.
- table: after a sort, screen readers hear the column that was clicked, also with multi-sort, and "Sort removed from …" when it leaves the sort.
- tabs: tab keys that differ only in punctuation or spacing (
a b,a-b) each get their own ids, so every tab still labels its own panel. - tags: a suggestion picked from the browser's list is added at once.
- toast: toasts shown together are all announced, not just the last, and toasts already showing move into a modal opened after them, where they can be clicked.
1.5.1 - 2026-11-13
Fixed
- alert, datepicker, date-range-picker, modal, pagination: smoother with Livewire. Each new flash message is announced, the pickers and the page sheet keep their open state through a render, and
openmodals also open afterwire:navigate. - color-picker: Enter on a three-digit colour (#abc) submits it as #aabbcc.
- number, phone, verification-code: pasting reads numbers with thousands separators (1,234), and a whole number or code pasted into a filled field replaces what was there. Undo in a number field always leaves a number.
- otp, verification-code: the complete event fires once per code, and a letter typed over an OTP digit keeps the digit.
- popover: clicking the trigger again closes it in Chrome and Edge.
- price-roll: accepts locales written as
de_DE, and shows a plain number for a currency code the browser doesn't know. - slider: readonly also holds for pointer drags.
- toast: appears in the top-most modal when several are open.
- tooltip-cursor: names an icon with no text for screen readers.
1.5.0 - 2026-11-12
Added
- calendar: events in a month, week or day view, or as an agenda on narrow screens. Multi-day bars, overlapping events side by side, a "more" list for busy days and a line at the current time. All-day events keep their dates in any timezone.
viewsadds a switch between views, the arrows change the period without reloading the page, andkeysreads your models' own fields. Works with Livewire.php artisan bladewell:add calendar - sortable: drag, keyboard and Move up/down reordering for lists and grids, like FAQs, menu links or photos. Moves are announced, undoable and keep focus.
move-urlsaves them one at a time,versioncatches conflicting edits, andnamesubmits the order asname[]. Works with Livewire.php artisan bladewell:add sortable - repeater: rows of fields people add, remove and reorder, like order lines. Rows are keyed, so old input, errors and focus stay with the right row.
min,max,compact,movableand Livewire actions.php artisan bladewell:add repeater - image-cropper: crop an image by drag, pinch or keyboard before it's uploaded, or send coordinates for the server to cut a stored one. Square, round or 16:9 frames, quarter turns, resized and EXIF-free output.
php artisan bladewell:add image-cropper - filter-builder: people build filters from field, condition and value rows, matching all or any.
FiltersandFilterFieldvalidate them and apply them to a query or a collection, the same on MySQL, PostgreSQL and SQLite. Works with Livewire.php artisan bladewell:add filter-builder
Changed
- button: its colours ease over a slightly longer moment on hover and press, and don't animate for people who've asked their system for less motion.
- time-picker, table, select: lighter markup for the time-picker, a new
TableSorthelper for the table (added bybladewell:add --installed), and a reorganised select script. Nothing looks or works differently.
Fixed
- tooltip-cursor: shows over an element whose middle is covered while its edges can still be seen, instead of staying hidden.
- file-upload: a long file name is cut short with an ellipsis on a narrow screen, instead of pushing its row out of the page.
- table, select, search, pagination: the usage notes' searches match the same on MySQL, PostgreSQL and SQLite, and
%and_match themselves. No widget changes.
1.4.11 - 2026-11-04
Fixed
- chat: the Livewire and history usage examples are more robust when messages arrive at the same time. No widget changes.
1.4.10 - 2026-11-03
Fixed
- chat, select, kanban, search, command, otp, verification-code, show-if: server-side usage examples and notes refined. No widget changes.
- datepicker, date-range-picker: the notes on timezones and caching are clearer. Run
php artisan boost:updatefor the matching Boost guidelines.
1.4.9 - 2026-11-03
Fixed
- kanban, file-upload, select, chat, table, date-range-picker: the usage examples now follow their own server notes. No widget changes.
1.4.8 - 2026-11-03
Fixed
- table: clickable rows accept the same links as search and command.
1.4.7 - 2026-11-03
Added
- password, otp, verification-code, text-input, textarea, number, tags, phone, checkbox, switch, datepicker, date-range-picker, time-picker, color-picker, select, table, pagination, chat, file-upload, search, command, kanban, tree, captcha: notes on what to check and what to keep cheap in the routes behind them, with OWASP and Laravel links. They show under "On the server" on each page, and under
considerinbladewell:list --jsonand the MCP server'sget_componentandadd_components. - bladewell:add points to those notes for the widgets you name, and the Laravel Boost guidelines and MCP server tell your agent to read them before writing a widget's routes. Run
php artisan boost:update. - kanban: a moved card rings for a moment where it lands, and red for longer when your route or Livewire component sends it back.
Fixed
- date-range-picker, modal: no "Using null as an array offset" deprecation on PHP 8.5 from a date range picker without
wire:modelorx-model, or a centred modal. - pagination: the footer shows "0 of 470" on a page with no rows, not "0–0", and no longer passes null to
number_format().
1.4.6 - 2026-10-31
Added
- tooltip, tooltip-cursor: on a touch screen, a long press on a button or link shows its tooltip without pressing it; a tap still presses. iOS's link preview is off on these elements.
- tooltip-cursor: on a touch screen, hold a chart bar and slide to read each bar without scrolling the page.
Fixed
- tooltip, tooltip-cursor: a tooltip opened by a finger shows above it, not under the finger.
1.4.5 - 2026-10-30
Added
- kanban: cards drag by touch: hold a finger on a card, then drag. A swipe still scrolls, and moves are saved as before.
1.4.4 - 2026-10-28
Added
- kanban: a new widget,
php artisan bladewell:add kanban. Columns of your own cards, moved by a Move menu, the keyboard, a tap or a mouse drag. Moves are announced, can be undone, firekanban:move, and withmove-urlare saved to your route, which can refuse them. Readonly boards and columns, locked cards, andwire:kanban-movein Livewire. - captcha: Turnstile, reCAPTCHA and hCaptcha work with
wire:model. The token is set when issued and cleared when it expires, and a form that fails validation gets a new one.
1.4.3 - 2026-10-27
Fixed
- toast: the layout usage note gave the default position as top-center; it's top-right.
- The Laravel Boost guidelines tell your agent not to wrap widgets in
wire:ignore, and to set a control's value from the server or Livewire, not a script. Runphp artisan boost:update.
1.4.2 - 2026-10-27
Added
- tags:
layout="below"keeps the box to one line and lists the tags under it.
Fixed
- chat: sending while scrolled up takes you to your message, and a reply that arrives meanwhile shows too.
- dropdown, popover: a panel opened after the window grew stays on screen. Pressing the same letter again in a dropdown moves to the next item starting with it.
- dropdown, popover, command: in a
disable-closemodal, Escape closes the menu, popover or palette on top and returns focus. - command: disabled items are greyed out and can't be run; stale results can't be chosen mid-search; no spinner is left after closing.
- otp: a pasted code fills from the first box, deleting in the middle closes the gap, and digits from any keyboard are read. verification-code reads them too.
- tags: a readonly field keeps its tags, and a paste over selected text replaces it.
- search: clearing the box clears the last suggestions.
- color-picker: emptying the hex box clears the swatch and preview.
- number: a readonly stepper ignores the arrow keys.
- captcha: showing another code empties the answer for
wire:modeltoo. - All widgets in a Livewire component (
ElementIds):Livewire::test()no longer throws "Duplicate element id" for a widget with its ownid. - tabs (
remember): an unreadable link entry no longer stops the other remembered tabs opening. - stepper: with no steps it draws nothing.
- toast: a tall stack scrolls, and an updated toast keeps focus on its close button.
- time-picker: Ctrl, Cmd and Alt shortcuts go to the browser, so Ctrl+A no longer switches a
segmentedtime to AM. - tooltip, tooltip-cursor: in a modal, Escape closes the tooltip first. Both stay placed after a resize or a late font.
- tree: open nodes stay open through a Livewire render, and checkbox parents show the right state at any depth.
1.4.1 - 2026-10-25
Fixed
bladewell:add --forceand the MCPforceoption overwrite only the widgets you name, nottheme.css,base.cssor shared widgets such asfield.- chat: line breaks survive the server's copy of a message; a refused message stays as Not sent with Edit; Livewire errors show under the box; older messages that fail to load offer Try again.
- file-upload: a rejected image restores the saved one, Retry respects
max-files, and resetting the form empties the widget. - select: readonly
multipleselects keep their choices; withsearch-url, only the latest search can show an error and added options stay. - datepicker, date-range-picker: without
minormaxthe calendar has no limit; changed limits apply on the next open; 29 February counts as 28 February forbirthdayandMinimumAge. - table: with several tables on a page, changing one leaves the others alone, and a failed filter can be retried.
- modal: Escape closes only the top modal, and
reset-on-closeresets any form. - time-picker: a
segmentedtime can be edited part by part, its arrows followstep, and typing 1 in a 12-hour list goes to 1:00. - number: reads digits from any keyboard, and a stepper without
minornegativestops at 0. - phone: reads digits from any keyboard, accepts a leading 00, and drops the national prefix for Russia, Kazakhstan and Hungary, in the browser and in
Countries::international(). bladewell:*commands: work whencomposer.jsonmaps a namespace to several directories.bladewell:mcpanswers batched requests.
1.4.0 - 2026-10-24
Added
- sidebar-layout: a new widget, an app frame with a sidebar (brand, accordion menu, footer), a fixed top bar and a scrolling page. On large screens it collapses to a rail of icons (
collapsed, andrememberto keep the choice in a cookie); on phones it slides in over the page. Apanelslot adds a side panel such as a chat. RTL and reduced motion supported. - accordion: an
iconprop onaccordion.menu-itemand menu groups, shown in a collapsed sidebar-layout. - icon:
panel-left. - chat: a new widget.
variant="assistant"for AI replies (Markdown, code blocks,streaming) andvariant="messages"for bubbles with names, avatars, times and delivery state. It opens at the newest message, keeps your place when new ones arrive, and loads older ones fromhistory-url. Parts:chat.message,chat.attachment,chat.divider,chat.typingandchat.composer(Enter to send, attachments,asyncsending,maxlength).compactfor narrow columns. Works withwire:submit,wire:modelandwire:stream. - auth-layout: a new widget for sign-in, sign-up and password pages, with a
title,subtitle, form and footer.variant="split"puts a brand panel beside the form;variant="centered"puts it on a card. No script.
Fixed
- accordion (
variant="menu"): closing a group while scrolled no longer leaves empty space and a useless scrollbar.
1.3.3 - 2026-10-22
Changed
- Theme:
--color-fielddarkens to#ebedf1and--color-mutedto#5d6679, so fields stand out and hints keep 4.5:1. Change these in your copiedtheme.css;bladewell:add --installeddoesn't. - All widgets: secondary text goes from
text-foreground/60to/70, to keep 4.5:1 on the darker field.
1.3.2 - 2026-10-14
Changed
- MCP server (
bladewell:mcp): results are compact JSON, using fewer tokens.
1.3.1 - 2026-10-13
Changed
- Laravel Boost guidelines: point your agent to
bladewell:list --jsonto find widgets. Runphp artisan boost:update.
1.3.0 - 2026-10-13
Changed
bladewell:addwith no names shows a searchable list to pick from (plain text on Windows).bladewell:listshows each widget and what it also installs, without descriptions; those are in--json.bladewell:addwith a mistyped name suggests the closest one and reports every unknown name. Exit codes are unchanged.- The package requires
laravel/prompts(^0.3), which every Laravel 12 and 13 app already has.
1.2.2 - 2026-10-13
Changed
- Laravel Boost guidelines: widget URLs (
suggest-url,search-url,children-url,upload-url) go inroutes/web.php, notroutes/api.php. - search, command: suggestions open only
http,https, same-site,mailto:andtel:links; others log a warning. - tree:
children-urlmust be on your own site.
1.2.1 - 2026-10-12
Fixed
- All form fields (
base.css): autofilled text follows a switch between light and dark at once.
1.2.0 - 2026-10-12
Added
- Guidelines for Laravel Boost in
resources/boost/guidelines: includebladewell/bladewellinboost:installand your agent learns how to find and add widgets.
1.1.0 - 2026-10-11
Added
- date-range-picker: on a touch screen, press a start day and slide to the end. Two taps still work, and slides elsewhere scroll.
- date-range-picker: a tap beside a day's button picks that day.
- button:
confirm, withconfirm-message,confirm-labelandconfirm-cancel, asks before it submits, links or runswire:click. - toast: a
data-toasthook shows a toast on click without a script (data-toast-message,data-toast-title;data-toast="dismiss"clears them). - select, tags, datepicker, date-range-picker, time-picker, color-picker, slider, otp, checkbox, switch, radio: a
readonlyprop: the value shows and submits but can't be changed.disabledwins over it, andwire:modelstill binds. - otp: an
infohint under the boxes. - popover, tabs, tree, clock, command: their script APIs are also on
window(window.popover…) and take an id or an element. - dropdown:
dropdown.open(),close()andtoggle(), also onwindow.dropdown, anddropdown-open/dropdown-closefrom Livewire. - modal, popover, dropdown, tabs, tree, clock, command, progress: a script call or Livewire event for a target that isn't on the page logs a warning.
- otp, select, textarea: events also sent as
otp:complete,select:changeandtextarea:resize. - verification-code: a
verification-code:completeevent with the code. - dropdown: a shared menu for long tables:
<x-widget.dropdown.menu id="…">once, and<x-widget.dropdown menu="…" :values="[…]">per row.:nameplaceholders take each row's values andonly-ifhides items per row. 100 rows go from 564 KB to 251 KB of HTML. New hooks:data-dropdown-values,data-dropdown-shared,data-dropdown-only-if. - table: the
compactexample uses the shared row menu. - datepicker: a
futureexample (min="today" :max="false").
Changed
- select, search, command, table: a prop name from one of the others now throws and names the right one (such as
suggest-urlon select, which takessearch-url), instead of doing nothing. - dropdown, popover: an icon-only trigger without
labelthrows, naming the dropdown or popover.
1.0.0 - 2026-10-09
Added
- modal: bottom sheets (
variant="drawer" side="bottom",mobile="sheet") swipe down to close when the backdrop may close them. New hook:data-modal-sheet. - pagination (
drawer, and the table's page sheet): swipes down to close too. - tooltip, tooltip-cursor: on a touch screen, a tap shows the tooltip on plain text, icons and chart bars; the next tap hides it.
- All widgets (
base.css):tap-targetandtap-target-ygive small controls a 44px tap area on touch screens without drawing them bigger. - radio:
variant="segmented", a single track for two to four short choices. - field:
visibleArea()andplaceBeside()exports, for placing popovers clear of the on-screen keyboard. - color-picker: a new form control: a hex box, the browser's picker (
custom) and optionalswatches. Works withwire:model. - command: a new widget, a command palette opened with Ctrl+K or Cmd+K. Groups and items, search by label or keywords,
suggest-urlfor your app's results, andrecent. - icon: 40 more icons for apps, commerce, editing and media.
- popover: a new widget, a panel beside a button that flips when there's no room and handles focus.
title,widthandalign;popover.open(),close()andtoggle();popover-open/popover-closefrom Livewire. - slider: a new form control, one thumb or a
rangeof two, withmin,max,step,prefixandsuffix. Works withwire:model. - tags: a new form control for free-text tags, with
suggestionsandmax. Submits asname[]and works withwire:model. - tree: a new widget with four looks (
list,cards,org,checkbox), lazy children fromchildren-url, and full keyboard support. Styled through--tree-line,--tree-indentand--tree-gap.
Changed
- modal, alert, toast, datepicker, date-range-picker: close buttons and month arrows get a 44px tap area on touch screens (
tap-target). - password, number, captcha, file-upload, select, pagination: small buttons get a 44px tap height on touch screens (
tap-target-y). - price-roll: the change badge wraps instead of running off a phone's edge.
- pagination (
jump): the on-screen keyboard's return key reads Go.
Fixed
- modal, toast, pagination: drawers, sheets and toasts stay clear of the notch and home indicator under
viewport-fit=cover. - search, select, phone, datepicker, date-range-picker, time-picker: lists and calendars open above the field when the on-screen keyboard leaves no room below.
0.3.0 - 2026-10-06
Changed
- All widgets: LarawellUI is now Bladewell. This release renames the package, commands, config and lock file, with no aliases; widgets and their props, hooks and copied code are unchanged. To upgrade:
composer remove --dev larawellui/larawellui && composer require --dev bladewell/bladewell- Rename
config/larawellui.phptoconfig/bladewell.php, if you published it. - Rename
larawellui.locktobladewell.lockbefore running any command, orbladewell:add --installedwill overwrite your edited files. - Use
php artisan bladewell:add | list | diff | mcpinstead oflarawell:*, and update your MCP client's config. - The site is now https://www.bladewellui.com.
0.2.3 - 2026-10-04
Added
- icon: names outside the built-in set are drawn by Blade Icons (
blade-ui-kit/blade-icons) when it's installed, in every widget's icon props.
0.2.2 - 2026-10-04
Added
- All widgets (
base.css): adata-theme-changinghook on<html>holds back colour transitions while the theme switches.
Changed
- button (
<x-widget.button.back>): the arrow sits closer to its label (gap-1.5).
Fixed
- table: changing page, sort or filter no longer reports CSP violations for the fetched page's inline styles.
- PHP helpers and validation rules: written in Pint's default style, so running Pint no longer marks them as edited.
0.2.1 - 2026-10-04
Added
- field: a
data-field-infohook on the hint.
Fixed
- All form widgets: a field with an error is described by the error alone; the hint returns once it clears.
- table: the sortable example no longer logs a PHP deprecation.
0.2.0 - 2026-10-03
Added
- show-if: a new widget that shows part of a form only while another field has a given value. Hidden fields don't submit or block the form.
- breadcrumbs: a new widget, a trail of links to the current page; one link back on phones.
- search: suggestions as you type from
suggest-url, with details, links and groups.suggest-minandmessagestune it. - select:
search-urlsearches your app as you type, single or multiple, withwire:model.search-min-length,searchingandsearch-failedtune it. - All widgets: a dark theme at WCAG AA, with
class="dark"ordata-theme="dark". - Theme:
primary-fill,error-fillandsuccess-fillfor backgrounds under white text;primary,errorandsuccessare for text, borders and tints. - icon: 24 more icons.
- All widgets:
examples-usein a manifest names the other widgets its examples need. - All widgets: every prop is described on its page, in
/r/*.jsonand through MCP.
Changed
- button, checkbox, accordion, datepicker, date-range-picker, modal, pagination, progress, stepper, tabs, time-picker: white text sits on the new fill colours.
- All widgets: a prop value that isn't allowed (
variant="primay") now throws and lists the allowed ones. See "Values from your data" in the README. - button:
typetakes only button, submit or reset. - dropdown: an item's
methodtakes only GET, POST, PUT, PATCH or DELETE. - file-upload:
uploadedneedsupload-url. - modal:
size="full"on a drawer, andmobile="sheet"on a drawer or full-screen dialog, now throw. - table: a row with both
hrefand details throws;bulk-methodtakes only GET, POST, PUT, PATCH or DELETE.
Fixed
- field: required checks skip fields in a disabled fieldset.
- time-picker: the list and columns are reachable with Tab and arrow keys.
- table: expandable rows open from a real Details button with
aria-expanded. - tooltip: around an icon with no text, the wrapper is an image named by the tooltip (
role="img"). - file-upload: inputs no longer get two labels.
- progress, search: examples pass contrast in dark mode.
- clock: the countdown no longer gets an empty
aria-label. - icon, clock, pagination: missing props added to the docs,
/r/*.jsonand MCP. - stepper: the bars stepper accepts the same step arrays as the others.
0.1.0 - 2026-10-02
Added
- 34 widgets: accordion, alert, button, captcha, checkbox, clock, date-range-picker, datepicker, dropdown, field, file-upload, icon, modal, number, otp, pagination, password, phone, price-roll, progress, radio, search, select, stepper, switch, table, tabs, text-input, textarea, time-picker, toast, tooltip, tooltip-cursor and verification-code.
bladewell:add, which copies widgets and what they need into your app, with--dry-run,--installedand--force.bladewell:list, with--json.bladewell:diff, showing how your edited copies differ from the package.bladewell:mcp, an MCP server for AI agents.bladewell.lock, so updates replace only files you haven't edited.- Livewire 3 and 4 support, with
wire:modelon every form control.