# DreamForm Changelog

Release notes for DreamForm.

## 1.4.2 — August 17, 2026

## 🐛 Bug fixes

- Normalize license domains consistently for `www.`, `staging.`, `test.` and `dev.` prefixes.
- Validate licenses with their assigned URL to prevent `Downloaded license is invalid` errors.

This is a Kirby 4 maintenance release.

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.4.1...1.4.2

## 2.2.1 — August 7, 2026

## 🐛 Bug fixes

- Fix Akismet compatibility issues with Kirby 5, correct API key verification and log validation failures (#172)
- Prevent overlapping requests from creating submissions without a submission date

## 📚 Documentation

- Clarify Akismet sender metadata requirements
- Remove the outdated comparison from the README

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.2.0...2.2.1

## 2.2.0 — July 13, 2026

## 🎉 Features

- Add a MailerLite action to create or update subscribers, assign groups and map additional form fields

## ✨ Enhancements

- Allow HTMX and API encryption to derive its secret from an explicitly configured Kirby `content.salt`; `tobimori.dreamform.secret` continues to take precedence (#171)

## 🐛 Bug fixes

- Prevent stale HTMX precognition responses from resetting newer values during rapid field interactions by synchronizing requests per field
- Display the writer field value button correctly in Firefox (#169)

## 🌐 Translations

- Add Brazilian Portuguese translation (#170)
- Update existing translations via LingoDotDev

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.1.7...2.2.0

## 2.1.7 — April 24, 2026

## 🐛 Bug fixes
- Use attribute selectors so digit-first form IDs work (2c3895cd2fbe72408922d7eff66614ff03501261, closes #167)
- Show correct label in placeholder pills with auto-generated kebab-case keys (6dca35e1cd2528731d8ca34ac0bf3c72abf1d7ae, closes #162)

## 2.1.6 — April 13, 2026

## 🐛 Bug fixes
- Use current language when saving multi-lang forms (faf38367aa56ff15acf8628fef3486e7fb514a50)
- Use form ID for hx-disabled-elt selector (faf38367aa56ff15acf8628fef3486e7fb514a50, closes #166)
- normalize www. prefix in license URL even without protocol (#159)

## 🌐 Translations
- Finnish translation by @lauriiii (#164)

## 2.1.5 — January 23, 2026

## 🎉 Features

 - Add `dreamform:migrate` CLI command to migrate forms from old email action syntax (pre-2.0) to new format. Run the following command with Kirby CLI:
 	
	```bash
	# Dry run
	kirby dreamform:migrate --dry-run
	
	# Apply migration
	kirby dreamform:migrate
	```

## 2.1.4 — January 21, 2026

## 🐛 Bug fixes

- Fix premature page creation when opening form create dialog (0381d51)

## 2.1.3 — December 19, 2025

## 🐛 Bug fixes

- Fix email attachment processing when value is not a string type (#156, thanks @FloWinge)

## 2.1.2 — December 5, 2025

## 🐛 Bug fixes

- Fix redirect path duplication when Kirby is installed in a subfolder (601778e)

## 2.1.1 — December 4, 2025

## 🐛 Bug fixes

- Fix aria-atomic attribute rendering as boolean instead of string (#154)

## 2.1.0 — November 20, 2025

## 🎉 Features

- Add option to hide empty error elements (#151)
- Add experimental background jobs support (using [kirby-queues](https://packagist.org/packages/tobimori/kirby-queues))

## 🐛 Bug fixes

- Fix file uploads not saved correctly when using multiple workflows (#148)
- Fix field value button styling (eb8e9f2)

## 🧹 Housekeeping

- Minimize composer install size
- Fix language server errors

## 2.0.3 — November 7, 2025

## 🐛 Bug fixes

- Fix email attachments getting lost in multi-step forms (#137)

## 2.0.2 — November 4, 2025

## 🐛 Bug fixes

- Fix email attachments not available in beforeSend closure (#137)
- Fix referer not correctly set when form is on a subpage (#102)
- Fix Brevo action not updating existing contacts (#149)

## 2.0.1 — October 11, 2025

## 🎉 Features

- Add bulk delete for submissions (#142)

## ✨ Enhancements

- Normalize domains for license validation to handle www vs non-www

## 🐛 Bug fixes

- Fix toolbar scrambled in writer fields (#145)
- Fix uploaded files not being saved when renaming in email action (#148)

## 2.0.0 — August 3, 2025

## 🚨 Breaking changes

- Require PHP 8.3.0 or higher, previously 8.2.0
- Require Kirby CMS 5, previously Kirby 4 (#111)
- Action blueprints restructured to use new dynamic field type - existing action configurations may need to be reconfigured (6caa0ae)
- Custom actions must define TYPE constant instead of implementing type() method

## 🎉 Features

- Add Kirby 5 support with updated permissions and deprecation fixes (#111, e8aa994)
- Add dark mode support, following Kirby's Panel theme (#127, 73a50d7)
- Add PHP 8.4 support (#100, e8aa994)
- Add precognition for real-time field validation - validates fields as users type and shows errors before submission (e79dd95, 7827a97)
- Add hCaptcha guard as alternative to Turnstile and reCAPTCHA (5020d30)
- Add Loops action for adding subscribers to a Loops newsletter list (947e9f3)
- Add Brevo action for adding subscribers to a Brevo list, formerly Sendinblue (33279db)
- Add custom template support for form pages, allowing developers to override the default form page template (#103, 80589c3)
- Add custom email template editing in the Panel (b5820e9)
- Add option to reject empty form submissions (d39eb76)
- Add new slug field with auto-generation from field labels (4279311)
- Add HTTP_HOST fallback for better server compatibility when detecting the current domain (15fb706)
- Add callable for custom page resolving logic (dc8c4d4)

## ✨ Enhancements

- Refactor to new storage handler architecture, fixing serialization issues with closures (#125, #122, 571770f)
- Migrate from SCSS to native CSS for smaller bundle size (e88ad00)
- Update Mailchimp action to fetch all available lists instead of requiring manual ID entry (#113, fdd70f9)
- Improve blueprint layouts on smaller screens (#119, 5be77ec)
- Omit sensitive details from API response mode for better security (#91, a93038f)
- Allow file upload field usage in forms with storage disabled (138a3c4)
- Add page title resolution in default email template - emails now show the page title instead of just the URL (#110, 5081919)

## 🐛 Bug fixes

- Fix current page not being set in HTMX mode, causing wrong page context (#128, 3dc44f5)
- Fix Brevo action crashing when no templates are configured (#129, 80737fe)
- Fix action log title being unreadable in dark backgrounds (#118, 6e0f010)
- Fix required attribute missing on textarea fields (#121, 46d9651)
- Fix global form errors not showing after submission (fb1cf39)
- Fix Loops action parameter handling (#105, #106, 9e1a55d, ee2fd59)
- Fix errors shown on initial page load when form has validation errors from previous attempt (#135, cc738da)
- Fix email attachments getting lost when multiple actions are defined (#137, 8cdd59f)
- Fix PRG redirect not showing success screen for single-step forms (904d660)
- Fix multi-language support when accessing form steps (b9fcf7a)
- Fix required field asterisk showing incorrectly (#93, aa56bd5)
- Fix Brevo action when no attributes are specified (067c9ca)

## 🧹 Housekeeping

- Add automated translations workflow via LingoDotDev (337bb61)
- Add PHP CS Fixer and ESLint CI workflows (5f1b61f)
- Move documentation into plugin (16776f7)
- Update all dependencies

## 2.0.0-rc.6 — July 30, 2025 (Pre-release)

Fix multilang handling

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.0.0-rc.5...2.0.0-rc.6

## 2.0.0-rc.5 — July 11, 2025 (Pre-release)

**There are breaking changes in this release: Some of your actions setups might not be backwards compatible.**

This is the GOLDEN RC if everything goes well. a full changelog, updated docs, etc. follows later,

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.0.0-rc.4...2.0.0-rc.5

## 2.0.0-rc.4 — June 13, 2025 (Pre-release)

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.0.0-rc.3...2.0.0-rc.4

## 2.0.0-rc.3 — June 6, 2025 (Pre-release)

### 🚀 Features
- New HCaptcha Guard

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.0.0-rc.2...2.0.0-rc.3

## 2.0.0-rc.2 — June 5, 2025 (Pre-release)

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/2.0.0-rc.1...2.0.0-rc.2

## 2.0.0-rc.1 — June 5, 2025 (Pre-release)

## 💥 Breaking Changes
  - Requires PHP 8.3.0 or higher (previously 8.2.0)
  - Requires Kirby CMS 5

  ### 🚀 Features

  #### Kirby 5 Support
  - Full compatibility with Kirby CMS 5
  - New license system implementation for K5
  - Dark mode support following Kirby's theme
  - Added support for PHP 8.4

  #### Precognition (Real-time Validation)
  - Validates form fields as users type
  - Shows errors before form submission
  - Allows storing partial submissions as pages
  
  #### New Email Service Integrations
 -  **Loops Action**: Add subscribers to a Loops list
 - **Brevo Action (formerly Sendinblue)**: Add subscribers to a Brevo list

  #### Other Improvements
  - Allow custom page templates for form pages
  - File attachments now work in email actions
  - HTTP_HOST fallback for server compatibility

  ### ♻️ Refactor
  - New storage handler architecture (#125)
  - Migrated from SCSS to native CSS
  - Raw Values for table layouts

  ### 🐛 Bug Fixes
  - Fixed HTMX page context issues
  - Blueprint layout handling (#119)
  - Global form errors now display correctly
  - Brevo action crash fixes
  - Textarea required attribute (#121)
  - Required field asterisk logic (#93)
  - File upload without storage
  - Kirby 5 permission handling
  - Multi-language support fixes
  - Accessibility improvements (ARIA attributes)
  - UI fixes including log readability (#118)
  - Page titles now get correctly resolved in email templates

  ### 🧹 Housekeeping
  - Automated AI translations 
  - PHP CS Fixer / ESLint workflows
  - Updated all dependencies
  - Documentation moved into plugin

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.5.0-rc.4...2.0.0-rc.1

## 1.5.0-rc.4 — November 19, 2024 (Pre-release)

## 🚀 Features
- New custom field for selecting static or dynamic field values (TODO: migration path for old actions)
- New Loops action

## 🐛 Bug Fixes
- `aria-hidden` attribute values are now valid in Lighthouse (thanks @gitlabisbetterthangithub!)
- Required asterisk is now correctly shown for checkboxes fields (thanks @gitlabisbetterthangithub!)

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.5.0-rc.3...1.5.0-rc.4

## 1.5.0-rc.3 — October 26, 2024 (Pre-release)

### 🚀 Features
- New Brevo action

### 🐛 Bug Fixes
- Remove sensitive details (like `spam`) from API submission response (closes #91)

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.5.0-rc.2...1.5.0-rc.3

## 1.5.0-rc.2 — October 17, 2024 (Pre-release)

### 🚀 Features

- Email action now supports sending attachments

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.5.0-rc.1...1.5.0-rc.2

## 1.5.0-rc.1 — October 17, 2024 (Pre-release)

### 🚀 Features

- **Precognition**: Live server-side field validation with HTMX (requires [Idiomorph](https://htmx.org/extensions/idiomorph/) extension)
- **Partial submissions**: Capture form data even if the respondent doesn't hit the submit button. Gather data from lost leads, find drop-off points, and improve your form conversion rates.

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.4.1...1.5.0-rc.1

## 1.4.1 — August 22, 2024

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.4.0...1.4.1

## 1.4.0 — August 22, 2024

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.3.5...1.4.0

## 1.3.5 — July 15, 2024

### 🐛 Bug Fixes
- File upload field now works when empty
 
**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.3.4...1.3.5

## 1.3.4 — July 8, 2024

### 🐛 Bug Fixes
- Auto-install now works on multi-lang sites
 
**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.3.3...1.3.4

## 1.3.3 — July 5, 2024

a bunch of bug fixes. detailed changelog follows later.

**Full Changelog**: https://github.com/tobimori/kirby-dreamform/compare/1.3.2...1.3.3