PHPackages                             burgerbuds/formalism-craft - 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 &amp; Views](/categories/templating)
4. /
5. burgerbuds/formalism-craft

ActiveCraft-plugin[Templating &amp; Views](/categories/templating)

burgerbuds/formalism-craft
==========================

Twig components for the Formalism field style framework

1.1.2(4y ago)2765[21 PRs](https://github.com/burgerbuds/formalism-craft/pulls)MITTwig

Since May 31Pushed 3y ago3 watchersCompare

[ Source](https://github.com/burgerbuds/formalism-craft)[ Packagist](https://packagist.org/packages/burgerbuds/formalism-craft)[ RSS](/packages/burgerbuds-formalism-craft/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (2)Versions (43)Used By (0)

Formalism
---------

[](#formalism)

[![](resources/img/plugin-hero.svg)](resources/img/plugin-hero.svg)

Formalism is a set of form components that deliver an amazing user experience with styles that can be customised to make it your own.

This plugin provides a range of functions to help create the HTML markup required for Formalism.

Formalism Craft creates the HTML and the styles are added from our separate npm package.

### Freeform integration

[](#freeform-integration)

Formalism is **form agnostic** but if you'd like to integrate it with Freeform, please read the **integration notes**.

Usage
-----

[](#usage)

Once you've got Formalism setup, you can create a basic input component in Twig with the following function:

```
{{ craft.formalism.input({
    label: 'Full Name',
    name: 'fullName',
    isRequired: true,
}) }}
```

This markup will be generated:

```

          Full Name

      *

```

After importing the input base and theme file:

```
@import 'formalism/input/base';
@import 'formalism/input/outlined';
```

There's plenty more field components like button, checkbox, checkboxGroup, date, file, input, radio, radioGroup, search, submit, switcher and textarea.

Features
--------

[](#features)

- Less JavaScript, more CSS
- Custom theme friendly
- Zero dependencies
- Small file size
- Supports style scoping
- Honors the reduced motion system feature
- Removes off-brand &lt;input&gt; autofill colors
- Removes mobile tap colors

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

[](#requirements)

This plugin requires Craft CMS 3.0.0-beta.23 or later.

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

[](#installation)

### Plugin installation

[](#plugin-installation)

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require burgerbuds/formalism-craft

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Formalism.

### Styles installation

[](#styles-installation)

1. To style the field components, install the npm package:

```
npm install formalism
```

1. Import the fields styles into your project. Here we're using the 'outlined' theme style for all of our fields.

Together these styles are only 5.66 kB (gzipped).

```
@import 'formalism/checkbox/base';
@import 'formalism/checkbox/outlined';

@import 'formalism/file/base';
@import 'formalism/file/outlined';

@import 'formalism/input/base';
@import 'formalism/input/outlined';

@import 'formalism/radio/base';
@import 'formalism/radio/outlined';

@import 'formalism/select/base';
@import 'formalism/select/outlined';

@import 'formalism/textarea/base';
@import 'formalism/textarea/outlined';

@import 'formalism/fieldset/base';
@import 'formalism/fieldset/outlined';

@import 'formalism/search/base';
@import 'formalism/search/outlined';
```

### Links and plugs

[](#links-and-plugs)

- [Swiff](https://github.com/simple-integrated-marketing/swiff) - A CLI app that makes working with a staging server easy-as-pie
- [Simple](https://simple.com.au/) - An Australian agency creating Craft websites

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 58.1% 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 ~51 days

Total

19

Last Release

1609d ago

Major Versions

0.0.5 → 1.0.22019-06-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/7a99b32efd3c22745f843c2a3c4394a8d27ec043ea086e25b40a36ef131bd61c?d=identicon)[burgerbuds](/maintainers/burgerbuds)

---

Top Contributors

[![ben-rogerson](https://avatars.githubusercontent.com/u/21288568?v=4)](https://github.com/ben-rogerson "ben-rogerson (43 commits)")[![bighoho123](https://avatars.githubusercontent.com/u/7004799?v=4)](https://github.com/bighoho123 "bighoho123 (15 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (7 commits)")[![simpleim](https://avatars.githubusercontent.com/u/35672585?v=4)](https://github.com/simpleim "simpleim (6 commits)")[![Kashkin](https://avatars.githubusercontent.com/u/3699310?v=4)](https://github.com/Kashkin "Kashkin (3 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginformalismform styles

### Embed Badge

![Health badge](/badges/burgerbuds-formalism-craft/health.svg)

```
[![Health](https://phpackages.com/badges/burgerbuds-formalism-craft/health.svg)](https://phpackages.com/packages/burgerbuds-formalism-craft)
```

###  Alternatives

[lewisjenkins/craft-dynamic-fields

Populate Craft fields with dynamic data using the power of Twig.

14667.0k](/packages/lewisjenkins-craft-dynamic-fields)[nystudio107/craft-minify

A simple plugin that allows you to minify blocks of HTML, CSS, and JS inline in Craft CMS templates.

37461.2k29](/packages/nystudio107-craft-minify)[jalendport/craft-preparse

A fieldtype that parses Twig when an element is saved and saves the result as plain text.

1086.4k](/packages/jalendport-craft-preparse)[craftpulse/craft-colour-swatches

Let clients choose from a predefined set of colours and utilise associated colour codes and class names in your templates.

3530.8k2](/packages/craftpulse-craft-colour-swatches)[verbb/footnotes

Adds a footnotes feature to CKEditor fields and Twig templates.

213.3k](/packages/verbb-footnotes)

PHPackages © 2026

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