PHPackages                             saeven/circlical-laminas-tailwind-forms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. saeven/circlical-laminas-tailwind-forms

ActiveLibrary[Templating & Views](/categories/templating)

saeven/circlical-laminas-tailwind-forms
=======================================

Build forms the Tailwind Way with Laminas

0.3.1(2y ago)45.9k↓50%MITPHPPHP ^7.4 | >=8

Since Jun 11Pushed 10mo ago2 watchersCompare

[ Source](https://github.com/Saeven/circlical-laminas-tailwind-forms)[ Packagist](https://packagist.org/packages/saeven/circlical-laminas-tailwind-forms)[ Docs](https://github.com/Saeven/circlical-laminas-tailwind-forms)[ RSS](/packages/saeven-circlical-laminas-tailwind-forms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (12)Versions (12)Used By (0)

Themed Forms for Laminas (with optional Tailwind/Alpine Goodies)
================================================================

[](#themed-forms-for-laminas-with-optional-tailwindalpine-goodies)

I built this rig to create a standardized "theme" approach to skinning Laminas forms. In a large team, people can often do things differently, rolling their own CSS. This puts a stop to this.

Design goals were:

- make the system as transparent as possible (no thick overrides) so that it survives Laminas/Form changes.
- allow you to define the look of a form with a single parameter (theme)
- enforce that themes are created only at the config level, in PHP
- don't interfere when classes are explicitly set, in other words, get out of the way if need be
- smallest footprint possible

Optional, since very opinionated:

- TODO: automate binding reactive models with AlpineJS
- TODO: automate writing XHR fetch scripts for forms, along with error display

Installation
============

[](#installation)

Coming Soon.

Usage
=====

[](#usage)

Coming Soon.

Tested Elements
---------------

[](#tested-elements)

You can see these behaviors in the unit tests. So far, I am happy with the support it offers:

- text fields
- buttons
- checkbox
- toggle (new)

Defining Default Styles
-----------------------

[](#defining-default-styles)

Take a look at config/module.config.php and look at the `form_themes/default-form-element` key. Those are the class names that you will want to define in your app's Tailwind configuration (e.g., with @apply). You can also override them at the element level when you define your forms (within init()).

To get you started, here some that I use in a project that leverages this library:

```
  .default-form-element {
      @apply shadow focus:ring-indigo-500 focus:border-indigo-500 block w-full sm:text-sm border-gray-300 rounded-md;
  }

  .default-form-element.error {
      @apply focus:ring-red-500 placeholder-red-300 focus:outline-none focus:ring-red-500 block w-full sm:text-sm border-red-300 rounded-md text-red-900;
  }

  .default-form-error {
      @apply mt-2 text-sm text-red-600;
  }

  .default-form-label {
      @apply block text-sm font-medium text-gray-700;
  }

  .default-form-button {
      @apply inline-flex justify-center py-2 px-4 border border-transparent shadow-sm text-sm font-medium rounded-md text-white bg-indigo-600 hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500;
  }

  .default-form-button-primary {
      @apply inline-flex justify-center py-2 px-4 border border-transparent shadow-sm text-sm font-medium rounded-md text-white bg-indigo-600 hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500;
  }

  .default-form-button {
      @apply bg-white py-2 px-4 border border-gray-300 rounded-md shadow-sm text-sm font-medium text-gray-700 hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500;
  }

  .default-form-help-block {
      @apply mt-2 text-sm text-gray-500;
  }

  .default-form-toggle {
      @apply self-start mt-2 bg-gray-200 relative inline-flex h-6 w-11 flex-shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors duration-200 ease-in-out focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2;
  }

  .default-form-toggle.active {
      @apply self-start mt-2 bg-indigo-600 relative inline-flex h-6 w-11 flex-shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors duration-200 ease-in-out focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2;
  }

  .default-form-toggle .toggle-control {
      @apply translate-x-0 pointer-events-none inline-block h-5 w-5 transform rounded-full bg-white shadow ring-0 transition duration-200 ease-in-out;
  }

  .default-form-toggle.active .toggle-control {
      @apply translate-x-5 pointer-events-none inline-block h-5 w-5 transform rounded-full bg-white shadow ring-0 transition duration-200 ease-in-out;
  }

  .default-radio-option {
      @apply h-4 w-4 border-gray-300 text-indigo-600 focus:ring-indigo-500;
  }

  .default-radio-label {
      @apply ml-3 block text-sm font-medium text-gray-700;
  }

  .default-file-element {
      @apply block w-full text-sm text-slate-500 file:mr-4 file:py-2 file:px-4 file:rounded-full file:border-0 file:text-sm file:font-semibold file:bg-indigo-50 file:text-indigo-700 hover:file:bg-violet-100;
  }

  .default-color-element {
      @apply block size-4 cursor-pointer ring-1 ring-zinc-200 ring-offset-1 disabled:pointer-events-none disabled:opacity-50;
  }

  .default-form-row {
      @apply mt-1;
  }

```

#### Implementation Notes

[](#implementation-notes)

- Delegators weren't an option for the forms, since the form names that are seen by FormElementManager::doCreate have varied 'resolvedName' values. Therefore, a delegator was instead used to "steal" FormElementManager out from under the ServiceManager. You will see that the ThemedFormDelegatorFactory does not use the callback provided by the service manager, instead, it returns something of a proxy object. In tests, there is no perceptible or deterministic performance impact.
- Themes are pushed into the Form Elements as they are added to the Forms provided by the library. This was necessary, since there is no link from the Element to the parent. It would have been more efficient to leave the theme data in the Form and have the helpers rely on that, but it is not possible without exhaustive modification to laminas/laminas-forms.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~50 days

Total

4

Last Release

1009d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/887224?v=4)[Alexandre Lemaire](/maintainers/Saeven)[@Saeven](https://github.com/Saeven)

---

Top Contributors

[![Saeven](https://avatars.githubusercontent.com/u/887224?v=4)](https://github.com/Saeven "Saeven (92 commits)")

---

Tags

laminaslaminas-formtailwindtailwindcsslaminastailwindformFormstailwindcss

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/saeven-circlical-laminas-tailwind-forms/health.svg)

```
[![Health](https://phpackages.com/badges/saeven-circlical-laminas-tailwind-forms/health.svg)](https://phpackages.com/packages/saeven-circlical-laminas-tailwind-forms)
```

###  Alternatives

[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[kokspflanze/zfc-twig

Laminas/Zend Framework Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

15299.3k4](/packages/kokspflanze-zfc-twig)[lm-commons/lmc-user

A generic user registration and authentication module for Laminas. Supports Laminas\\Db and Doctrine2.

1880.7k5](/packages/lm-commons-lmc-user)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)