# Easy Forms for Statamic

> Build professional, accessible frontend forms for Statamic sites with minimal code using a single Antlers tag.

## What is Easy Forms?

Easy Forms is a Statamic addon that renders complete, styled, accessible forms with one tag: `{{ easyform handle="your_form" }}`. It eliminates the need to write repetitive form markup while providing 17+ field types, WCAG 2.1 Level AA accessibility, and built-in security features.

## Key Features

- **One-Tag Rendering**: `{{ easyform handle="contact_form" }}` outputs a complete, working form
- **17+ Field Types**: Text, textarea, select, radio, checkbox, date picker, phone (240+ countries), file upload, rating, toggle, counter, grid (repeater), group, and more
- **WCAG 2.1 Level AA Accessible**: All components meet accessibility standards out of the box
- **Built on Alpine.js + Tailwind CSS**: Modern, lightweight stack (5KB JS uncompressed)
- **Security Built-in**: CSRF protection, honeypot spam detection, optional reCAPTCHA v3
- **Wizard Mode**: Multi-step forms using blueprint sections
- **Laravel Precognition**: Real-time server-side validation
- **Conditional Fields**: Full support for Statamic's conditional field logic
- **Email Templates**: Pre-built notification templates included

## Quick Start

1. Install: `composer require reachweb/statamic-easy-forms`
2. Run setup: `php artisan easy-forms:install`
3. Create a form in Statamic Control Panel
4. Add to template: `{{ easyform handle="your_form_handle" }}`

## Documentation Structure

- Overview: /overview
- Installation: /installation
- Quick Start: /quick-start
- Easy Form Tag: /easy-form-tag
- Configuration Options: /configuration-options
- Field Types: /fields/text-fields, /fields/select-combobox, /fields/checkboxes, /fields/radio-buttons, /fields/date-picker, /fields/phone, /fields/assets-files, /fields/rating, /fields/toggle, /fields/counter, /fields/integer, /fields/time, /fields/spacer, /fields/dictionaries, /fields/grid, /fields/group
- Wizard Mode: /wizard
- Security & Anti-spam: /security-antispam
- Laravel Precognition: /laravel-precognition
- Email Templates: /email-templates
- Events & Tracking: /events
- Localization: /localization

## Common Use Cases

- Contact forms
- Newsletter signups
- Multi-step application forms
- File upload forms
- Survey and feedback forms
- Registration forms

## Links

- Documentation: https://easy-forms.dev
- Live Demo: https://demo.easy-forms.dev
- GitHub: https://github.com/reachweb/statamic-easy-forms
- Statamic Marketplace: https://statamic.com/addons/reach/easy-forms

## Requirements

- Statamic 5.x
- PHP 8.2+
- Alpine.js 3.x with Focus plugin
- Tailwind CSS v4 (recommended)