CakePHP TailwindUi Plugin

May 4, 2026 · View on GitHub

This branch is for CakePHP 5.2+. See version map for details.

Tailwind CSS / DaisyUI view helpers for CakePHP 5.2+.
Drop-in replacement for Bootstrap-styled helpers — outputs Tailwind/DaisyUI markup instead.

This plugin is the Tailwind equivalent of bootstrap-ui.

Preview

$this->Form->control(), $this->Paginator->links(), $this->Flash->render(), and $this->Html->badge() rendered with the default DaisyUI preset:

See docs/ for the full set of screenshots and documentation.

Installation

composer require dereuromark/cakephp-tailwind-ui

Load the plugin:

bin/cake plugin load TailwindUi

Quick Start

In your AppView::initialize():

use TailwindUi\View\UiViewTrait;

class AppView extends View
{
    use UiViewTrait;

    public function initialize(): void
    {
        parent::initialize();
        $this->initializeUi();
    }
}

All $this->Form->control(), $this->Paginator->links(), $this->Flash->render(), and $this->Breadcrumbs->render() calls now output DaisyUI-styled markup.

Class Map

The plugin uses a configurable class map. DaisyUI is the default. To switch to KTUI (Metronic):

// In config/bootstrap.php or Application::bootstrap()
Configure::write('TailwindUi.classMap', 'ktui');

Partial overrides:

Configure::write('TailwindUi.classMap', [
    'form.input' => 'my-custom-input-class',
]);

Helpers

Helper	Description
FormHelper	Text, select, checkbox, radio, switch, textarea, file, range, input groups, horizontal layout
PaginatorHelper	`links()` method with join/flex container
FlashHelper	Alert rendering with icons
BreadcrumbsHelper	Breadcrumb navigation
HtmlHelper	`badge()`, `alert()`, and `icon()` methods

Class Map Presets

Preset	Framework	Usage
`daisyui` (default)	DaisyUI	No config needed
`ktui`	KTUI/Metronic	`Configure::write('TailwindUi.classMap', 'ktui')`

Custom presets can be added by placing a PHP file in config/class_maps/ that returns an array.