PHPackages                             symfinity/ux-blocks-form - 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. symfinity/ux-blocks-form

ActiveSymfony-bundle[Templating & Views](/categories/templating)

symfinity/ux-blocks-form
========================

Form domain Twig components: labels, inputs, compounds, and native interaction CSS

v0.1.0(today)00MITPHPPHP >=8.2CI passing

Since Jun 23Pushed todayCompare

[ Source](https://github.com/symfinity/ux-blocks-form)[ Packagist](https://packagist.org/packages/symfinity/ux-blocks-form)[ Docs](https://github.com/symfinity/ux-blocks-form)[ RSS](/packages/symfinity-ux-blocks-form/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (18)Versions (2)Used By (0)

UX Blocks Form
==============

[](#ux-blocks-form)

### Form domain Twig components: labels, inputs, compounds, and native interaction CSS

[](#form-domain-twig-components-labels-inputs-compounds-and-native-interaction-css)

[![PHP Version](https://camo.githubusercontent.com/fe60a3918bae3bc2ed56c6c5329ac0cb7462196b3061d0afb91fc4a241fe4172/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d3737374242343f7374796c653d666c6174266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](composer.json)[![Symfony](https://camo.githubusercontent.com/0b9a123c2224a4e7dbbb624492f493b4fbb810e2060e7ddbec9346b13a65ac24/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e342b2d3334333433343f7374796c653d666c6174266c6f676f3d73796d666f6e79266c6f676f436f6c6f723d7768697465)](composer.json)
[![CI](https://github.com/symfinity/ux-blocks-form/actions/workflows/ci.yml/badge.svg)](https://github.com/symfinity/ux-blocks-form/actions/workflows/ci.yml)
[![Release](https://camo.githubusercontent.com/3b16083c5228cf328714b3435ae0e8c62ee5354d954ef3e88ccbccf453870f7d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73796d66696e6974792f75782d626c6f636b732d666f726d2e7376673f7374796c653d666c6174266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/symfinity/ux-blocks-form)[![Downloads](https://camo.githubusercontent.com/e0d67ec3a04d4af997d35630d13aba67868db26be4bd69e5b58773ed358295e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d66696e6974792f75782d626c6f636b732d666f726d2e7376673f7374796c653d666c6174266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/symfinity/ux-blocks-form)[![License](https://camo.githubusercontent.com/f48f8d6cf609f5b181b9c3218a85175fe8a5809c7ea400347f39697a5d55065d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c6174)](LICENSE)

Note

**Read-only mirror.**See [CONTRIBUTING.md](CONTRIBUTING.md) for how to propose changes.

Features
--------

[](#features)

- **Seventeen form roles** — labels, text controls, toggles, selects, compounds, and form shells
- **Native-first (`nat`)** — styled with ui-kernel tokens and package CSS; no Stimulus required for default markup
- **Composition compounds** — `Field` and `FloatingField` with labelled regions for control, hint, and error text
- **Toggle button appearance** — `appearance="button"` on `Checkbox`, `Radio`, and segmented `RadioGroup`
- **Input adornments** — icon slots and automatic icons on date/time inputs
- **Symfony UX Twig components** — ``, ``, ``, and siblings
- **Flex recipe** — bundle registration on install
- **Optional Symfony Form bridge** — pair with `symfinity/form-ui-extensions-bundle` for `FormView` widgets

`button` and `button-group` ship in `**symfinity/ux-blocks-core`\*\* (used by `InputGroup` and toggle-button labels).

Interaction profile
-------------------

[](#interaction-profile)

TokenIn this package`nat`Default for all roles — native HTML + ui-kernel / package CSS`act`Toggle-button labels use core `Button` chrome; `InputGroup` composes core `Button``stl`**Not included** — overlay components ship in `symfinity/ux-blocks-extended``live`**Not included** — LiveComponents ship in separate packagesComponent inventory
-------------------

[](#component-inventory)

RoleTwigInteractionFragmentStatuslabelLabelnat`blocks.label`shippedinputInputnat`blocks.input`shippedtextareaTextareanat`blocks.textarea`shippedcheckboxCheckboxnat`blocks.checkbox`shippedradio-groupRadioGroupnat`blocks.radio-group`shippedselectSelectnat`blocks.select`shippedswitchSwitchnat`blocks.switch`shippedfile-inputFileInputnat`blocks.file-input`shippedinput-groupInputGroupnat`blocks.input-group`shippedfieldsetFieldsetnat`blocks.fieldset`shippedfieldFieldnat`blocks.field`shippedfloating-fieldFloatingFieldnat`blocks.floating-field`shippedrangeRangenat`blocks.range`shippedradioRadionat`blocks.radio`shippedformFormnat`blocks.form`shippedform-actionsFormActionsnat`blocks.form-actions`shippedfile-uploadFileUploadnat`blocks.file-upload`shipped**Highlights:** `Select` supports `multiple` and enhanced styling where the browser allows; `Range` optional value readout; `FileUpload` combines a button with a filename display; do not wrap `Select` inside `FloatingField`; `FormActions` supports `align`: `start`, `stretch`, or `end`.

Handbook: [docs/components.md](docs/components.md).

Prerequisites
-------------

[](#prerequisites)

Add the [symfinity/recipes](https://github.com/symfinity/recipes) Flex endpoint to your project's `composer.json` (see [recipes README](https://github.com/symfinity/recipes/blob/main/README.md)) — recipes are not in Symfony's official recipe repository yet.

Installation
------------

[](#installation)

```
composer require symfinity/ux-blocks-form
```

Composer installs `symfinity/ux-blocks-core` and `symfinity/ux-blocks` automatically. The Flex recipe registers the bundle for all environments. See [Installation](docs/installation.md) for manual setup and verification.

Pair with `**symfinity/ui-kernel**` when you need theme CSS — see [Quick start](docs/quickstart.md).

Quick Start
-----------

[](#quick-start)

```
{# templates/base.html.twig — ui-kernel head (recommended) #}

    {{ ui_kernel_theme_boot_script() }}
    {{ ui_kernel_css()|raw }}

```

```
{# templates/register.html.twig #}

        Sign up

```

```
{# Segmented choice — toggle button appearance #}

```

See [Quick start](docs/quickstart.md) for validation states and optional Form bridge pairing.

Documentation
-------------

[](#documentation)

- **[Quick start](docs/quickstart.md)** — first form layout in minutes
- **[Installation](docs/installation.md)** — Flex, dependencies, verify
- **[Configuration](docs/configuration.md)** — optional bundle settings
- **[Components](docs/components.md)** — role index and fragment prefix
- **[Upgrade](docs/upgrade.md)** — first release and future migrations

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Symfony 7.4 or 8.x
- Transitive: `symfinity/ux-blocks-core` ^0.1, `symfinity/ux-blocks` ^0.1

Support
-------

[](#support)

- [GitHub Issues](https://github.com/symfinity/ux-blocks-form/issues)
- [Security](.github/SECURITY.md)
- [Contributing](CONTRIBUTING.md)

License
-------

[](#license)

[MIT](LICENSE)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/246582257?v=4)[Symfinity](/maintainers/symfinity)[@symfinity](https://github.com/symfinity)

---

Tags

design-systemsformssymfonysymfony-bundletwig-componentsux-blockssymfonysymfony-uxFormsSymfony Bundledesign-systemtwig-componentsux-blocks

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/symfinity-ux-blocks-form/health.svg)

```
[![Health](https://phpackages.com/badges/symfinity-ux-blocks-form/health.svg)](https://phpackages.com/packages/symfinity-ux-blocks-form)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M373](/packages/easycorp-easyadmin-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1715.6k12](/packages/2lenet-crudit-bundle)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9317.2k55](/packages/open-dxp-opendxp)[forumify/forumify-platform

122.0k12](/packages/forumify-forumify-platform)

PHPackages © 2026

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