Skip to content
TallCraftUI

Changelog

Every TallCraftUI release, newest first. TallCraftUI follows semantic versioning; breaking changes only land in major versions. Upgrading? Read the upgrade guide.

Version 3.x

First beta of TallCraftUI 3.0 with Livewire 4, Laravel 13 and Tailwind CSS 4.1 support, a CSS-first installer and hardened Markdown uploads. Not for production yet.

Requirements

  • PHP 8.2+, Laravel 12 or 13, Livewire 4 and Tailwind CSS 4.1+.

Breaking changes

  • Dropped support for Laravel 10 and 11, Livewire 3 and PHP 8.1.
  • <x-select> and <x-color-picker> follow wire:model modifiers instead of always syncing immediately. Use wire:model.live for the previous behavior.
  • The Markdown upload endpoint validates file type and size, only accepts disks listed in tallcraftui.upload.disks, rejects folder names containing .. or a leading slash, and expects the CSRF token in a header.
  • HasMarkdownImages only deletes images inside the model's markdown folder ($markdownImageFolder, default markdown).
  • WithTcTable::updated() was renamed to updatedWithTcTable().
  • <x-tr href> no longer navigates when clicking buttons, links or form controls inside the row.
  • Removed the global Toast helper functions from window (window.toast() is unchanged).
  • Replaced the gehrisandro/tailwind-merge-laravel dependency with gehrisandro/tailwind-merge-php. The @twMerge directive and twMerge() helper are no longer installed.
  • The installer no longer edits tailwind.config.js.

Added

  • upload config section: enabled, middleware, disks, mimes and max_size.
  • tcSortableColumns() whitelist for WithTcTable sorting.
  • wire:navigate and Ctrl/Cmd-click support on <x-tr href>.
  • Default primary and secondary theme colors, and the component @source path, in tallcraftui.css.
  • tallcraftui-theme-changed window event, which keeps several <x-theme-toggle /> instances in sync.
  • window.TallCraftUI namespace for shared JavaScript.
  • TallCraftUiServiceProvider::components() returns the component name map.

Changed

  • Modal, Drawer, Tab, Accordion, Rating, Password, ColorPicker, Markdown and Select bind with x-modelable instead of @entangle.
  • Toast error handling uses Livewire.interceptRequest.
  • The installer adds missing app.css lines after existing @import rules, adds the class-based dark variant, installs packages with the Process facade, detects the package manager from the lockfile, and picks the tc- prefix when the app already has components with the same names.
  • <x-select> uses outline-hidden instead of outline-none.

Deprecated

  • Sorting a WithTcTable component without tcSortableColumns(). It will be required in 4.0.

Fixed

  • <x-password> dropped wire:model modifiers such as .live.
  • Two-way bound components failed without wire:model or outside a Livewire component.
  • <x-select> didn't update when the bound property changed on the server.
  • <x-markdown> initialized the editor twice when loading a value.
  • Error toasts didn't work when the toast first rendered on a wire:navigate page.
  • WithTcTable didn't run its update hook when the component defined its own updated().
  • Installing on Laravel 13 apps that use Guzzle 8.
  • Dark mode flashed light before Alpine started, and wasn't reapplied after wire:navigate.
  • The installer duplicated lines when re-run and overwrote a published config.
  • New config keys were missing when using an older published config.
  • Removed the Tailwind v3-only bg-opacity-90 class from <x-tooltip>.

Security

  • Markdown uploads: restricted file types (no SVG or HTML), size limit, disk allowlist and folder validation.
  • HasMarkdownImages could delete any file on the disk through user-written markdown.
  • WithTcTable passed the client-controlled sortCol to the query, including relation names called as model methods.
  • <x-tr href> rendered the URL into an inline onclick, allowing javascript: URLs.

Version 2.x

Maintenance

  • Bumped league/commonmark to 2.8.2 and gehrisandro/tailwind-merge-laravel to 1.4.0.

Maintenance

  • Bumped league/commonmark to 2.8.1, laravel/pint to 1.29.0 and blade-ui-kit/blade-heroicons to 2.7.0.

Changed

  • README links point to the official TallCraftUI website.

Maintenance

  • Bumped symfony/process to 7.4.5.

Added

  • Theme Toggle: new component, contributed by @IceWolf0110.

Changed

  • Menu: updated ring opacity.

Maintenance

  • Bumped league/commonmark to 2.7.0 and laravel/pint to 1.22.1.

Tailwind CSS 4 and Laravel 12 support, and a new searchable Select component.

Requirements

  • Tailwind CSS 4.

Breaking changes

  • The select component was renamed to native-select. <x-select> is now the new searchable select.

Added

  • Select: new component with search, multiple selection and custom option rendering.
  • Badge: slot support.
  • The installer installs and imports the @tailwindcss/forms plugin.

Changed

  • Refactored components for better reusability and maintenance.
  • Button: refactored sizes.

Added

  • Support for Tailwind CSS 4.
  • Support for Laravel 12.
  • The installer installs and imports the @tailwindcss/forms plugin.

Version 1.x and earlier

Added

  • Badge: slot support.

Changed

  • Button: refactored sizes.

Maintenance

  • Dependency updates.

Added

  • Progress: new component.
  • Progress Radial: new component.

Changed

  • Button: refactored.
  • The Tailwind content path is now ./vendor/developermithu/tallcraftui/src/**/*.php.

Fixed

  • Input: dynamic sizes.
  • Select: dynamic sizes.

Added

  • Table: sort by relationship fields.
  • Table: no-spinner prop.
  • Table: target property for the loading spinner.

Changed

  • Table: explicit border color.
  • Dropdown: list style and border.
  • Toggle and Label: preserve the case of the label.

Fixed

  • Table: attribute merging.
  • Table: the search field no longer submits the surrounding form.

Security

  • Security fixes.

Added

  • Rating: new component.
  • Markdown: new component.

Security

  • Fixed a security issue.

Changed

  • Toast: the default type is success, so $this->toast('Default toast') works without a type.

Security

  • Fixed security issues.

Added

  • Toast: new component.
  • Table: disable the loading effect with no-loading.
  • Accordion: title slot, icon slot and class:icon.
  • class:label in all form components.

Fixed

  • Tab: issue #2.

Added

  • Tooltip: new component.
  • Range: new component.
  • Clipboard: new component.

Changed

  • Accordion: no underline when hovering the title.

Added

  • Password: new component.
  • Color Picker: new component.
  • Tab: new component.
  • Accordion: new component.
  • Card: new component.

Fixed

  • Bug fixes.

Added

  • Spinner: new component.
  • Toggle: color and size variants.
  • Table: hoverable attribute.

Changed

  • Table: keeps the page layout after paginating.

Added

  • Drawer: new component.
  • Dropdown: fade, slide, flip and rotate animations.
  • Modal: without-trap-focus attribute and close event.

Fixed

  • The install:tallcraftui command.

Added

  • Modal: dismissible and blur-none attributes.
  • Dropdown: title and icon attributes.
  • TALLCRAFTUI_PREFIX environment variable.

Fixed

  • Focus border color of the input, textarea and select components.

Added

  • Stat: new component.
  • Menu and Menu Item: new components.
  • Separator: new component.
  • Dropdown and Modal: no-transition attribute.

Changed

  • Refactored config/tallcraftui.php.

Breaking changes

  • Removed the tertiary, warning, danger, info and success colors. Only primary and secondary are configured.

Added

  • Badge: new component.
  • Toggle: new component.
  • Textarea: auto-resize attribute.
  • Tailwind colors emerald, teal, blue, indigo and violet.
  • Support for tailwind-merge-laravel.

Breaking changes

  • Input: the preffix attribute was renamed to prefix.

Changed

  • Modal: the default size changed from 2xl to lg.

Fixed

  • Input: the error message broke the layout with prefix, suffix, prepend or append.
  • Radio: the primary color didn't apply.

Added

  • Dropdown: new component.

Fixed

  • Alert: the title attribute didn't work.

Added

  • Tailwind CSS color support.
  • Breadcrumb: new component.
  • Modal: new component.

Added

  • Dark mode support.
  • MIT license.

Changed

  • Refactored components.

First release.

Added

  • Input, Icon, Button, Textarea, Select, Radio, Checkbox and Alert components.