CakePHP TailwindUi Plugin

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.

Documentation

• Installation
• Class Map
• Helpers
• Presets — DaisyUI, KTUI, custom
• Bake Theme
• Screenshots