PHPackages                             bgaze/bootstrap-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. [Utility & Helpers](/categories/utility)
4. /
5. bgaze/bootstrap-form

ActiveLibrary[Utility & Helpers](/categories/utility)

bgaze/bootstrap-form
====================

Bootstrap 4 & 5 forms builder for Laravel 12+

v4.0.4(2w ago)5253.0k↑1533.3%5MITPHPPHP ^8.2

Since Nov 11Pushed 1y ago4 watchersCompare

[ Source](https://github.com/bgaze/bootstrap-form)[ Packagist](https://packagist.org/packages/bgaze/bootstrap-form)[ RSS](/packages/bgaze-bootstrap-form/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (13)Versions (24)Used By (0)

Bootstrap 4 & 5 forms builder for Laravel 12+
==================================================

[](#bootstrap-4--5-forms-builder-for-laravel-12-)

[![Tests](https://github.com/bgaze/bootstrap-form/actions/workflows/tests.yml/badge.svg)](https://github.com/bgaze/bootstrap-form/actions/workflows/tests.yml)[![GitHub license](https://camo.githubusercontent.com/4b7f7670e0e5f5483139300b6c5dd680028c5b6acd639dc1c2cce69ab854f74f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6267617a652f626f6f7473747261702d666f726d)](https://github.com/bgaze/bootstrap-form/blob/master/LICENSE)[![Maintenance](https://camo.githubusercontent.com/fddb9ea02ac78bc1274215fb8c984c63470c9cf1380c90e1fceb44011b6582a8/68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f32303330)](https://camo.githubusercontent.com/fddb9ea02ac78bc1274215fb8c984c63470c9cf1380c90e1fceb44011b6582a8/68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f32303330)[![GitHub release (latest by date)](https://camo.githubusercontent.com/54a8e95fa243a4c219c3aa86333e8a5cea1b3bacba966cade5b67def495bfe73/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6267617a652f626f6f7473747261702d666f726d)](https://camo.githubusercontent.com/54a8e95fa243a4c219c3aa86333e8a5cea1b3bacba966cade5b67def495bfe73/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6267617a652f626f6f7473747261702d666f726d)[![GitHub Repo stars](https://camo.githubusercontent.com/8f3468aa494cd97a7998a384f47b5fc12414c12affdf3afbe9f1ee80a042cba6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6267617a652f626f6f7473747261702d666f726d3f7374796c653d666c6174)](https://github.com/bgaze/bootstrap-form/stargazers)[![Packagist](https://camo.githubusercontent.com/7b106e8fb01e6b81fd73b684ef03816c87489d55807ea7dfc3174fcdc63cb08d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6267617a652f626f6f7473747261702d666f726d)](https://camo.githubusercontent.com/7b106e8fb01e6b81fd73b684ef03816c87489d55807ea7dfc3174fcdc63cb08d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6267617a652f626f6f7473747261702d666f726d)

This package simplifies Bootstrap forms creation in Laravel applications, rendering all markup through its own lightweight HTML/form layer.

It renders **Bootstrap 5** markup by default and **fully supports Bootstrap 4** for backward compatibility.

Model form binding and automatic error display are supported, as well as most Bootstrap form features: form layouts, custom fields, input groups, and more.

Any contribution or feedback is highly welcomed, please feel free to create a pull request or [submit a new issue](https://github.com/bgaze/bootstrap-form/issues/new).

ℹ️ v4 status — functional, documentation in progress
----------------------------------------------------

[](#ℹ️-v4-status--functional-documentation-in-progress)

v4 is functional and tested, but its full documentation is still being written.

In the meantime, the [LLM usage guide](docs/llm/index.md) shipped in this repository is the **authoritative, up-to-date reference** (dense but exact — usable by humans and AI assistants alike).

> The [full documentation site](https://packages.bgaze.fr/bootstrap-form) still reflects v3 and will be regenerated for v4.

⚠️ Upgrading — v4 has breaking changes
--------------------------------------

[](#️-upgrading--v4-has-breaking-changes)

v4 introduces **breaking changes** over v3 (see [What's new](#whats-new-in-v4) below).

To keep using a previous major version, require it explicitly and refer to its dedicated branch:

VersionInstallDocs**v3** (Bootstrap 4 default, B5 opt-in)`composer require "bgaze/bootstrap-form:^3.0"`[v3 branch](https://github.com/bgaze/bootstrap-form/tree/v3) · [site](https://packages.bgaze.fr/bootstrap-form)**v2** (Bootstrap 4 only)`composer require "bgaze/bootstrap-form:^2.0"`[v2 branch](https://github.com/bgaze/bootstrap-form/tree/v2) · [site](https://packages.bgaze.fr/bootstrap-form)What's new in v4
----------------

[](#whats-new-in-v4)

- **No more third-party dependency**
    The historical `laravelcollective/html` dependency is gone, replaced by an internal, iso-rendering HTML/form layer owned by the package.
- **Bootstrap 5 is now the default**
    Bootstrap 4 remains fully supported for backward compatibility (frozen), switchable via `bootstrap_version` globally, per form (`BF::open(['bootstrap_version' => 4])`), or per field.
- **Laravel 12 & 13, PHP 8.2+**
    Older versions dropped.
- **x-components**
    A new Blade component syntax (``) alongside the directives and the `BF` facade; all three render identical markup.
- **Richer choice grammar for select/checkboxes/radios**
    Optgroups, per-option attributes, accepting any `iterable` (array, Collection, generator).
- **New field types & layouts**
    `datetime-local`, `month`, `week`, `search` inputs, Bootstrap 5 floating labels, opt-in valid feedback, and accessible `aria-describedby` / `aria-invalid` wiring.
- **LLM-optimized documentation**
    See [`docs/llm/`](docs/llm/index.md) (+ [`llms.txt`](llms.txt)).

Quick start
-----------

[](#quick-start)

### Requirements

[](#requirements)

- PHP **8.2+**
- Laravel **12** or **13**

### Installation

[](#installation)

Install the package using Composer:

```
composer require bgaze/bootstrap-form
```

Several configuration options are available; publish the configuration file to customize them:

```
php artisan vendor:publish --provider="Bgaze\BootstrapForm\BootstrapFormServiceProvider"
```

### Usage

[](#usage)

Forms can be built through three interchangeable syntaxes that produce byte-identical HTML:

**x-components**

```

    Save

```

**Blade directives**

```
@open(['url' => '/x'])
@text('field')
@submit('Save')
@close
```

**BF facade**

```
echo BF::open(['url' => '/x']);
echo BF::text('field');
echo BF::submit('Save');
echo BF::close();
```

License
-------

[](#license)

Open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance65

Regular maintenance activity

Popularity42

Moderate usage in the ecosystem

Community13

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 98.2% 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 ~116 days

Recently: every ~2 days

Total

22

Last Release

15d ago

Major Versions

v1.0.9 → v2.0.02025-03-23

v2.0.0 → v3.0.02026-07-09

v3.0.0 → v4.0.02026-07-14

v1.x-dev → v4.0.12026-07-14

PHP version history (3 changes)v1.0.0PHP >=7.0

v2.0.0PHP >=7.2.5

v4.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/4f4a5f965ee3485d7f2c78450a371d363027a7f10935d6559869874a584d5402?d=identicon)[bgaze](/maintainers/bgaze)

---

Top Contributors

[![bgaze](https://avatars.githubusercontent.com/u/985214?v=4)](https://github.com/bgaze "bgaze (55 commits)")[![ronvdberkmortel](https://avatars.githubusercontent.com/u/11784967?v=4)](https://github.com/ronvdberkmortel "ronvdberkmortel (1 commits)")

---

Tags

laravelbootstrapform

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bgaze-bootstrap-form/health.svg)

```
[![Health](https://phpackages.com/badges/bgaze-bootstrap-form/health.svg)](https://phpackages.com/packages/bgaze-bootstrap-form)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.5k30.2M156](/packages/laravel-cashier)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k16.3M146](/packages/laravel-pulse)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9922.4M142](/packages/roots-acorn)[api-platform/laravel

API Platform support for Laravel

58174.6k19](/packages/api-platform-laravel)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45844.8k1](/packages/pressbooks-pressbooks)

PHPackages © 2026

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