Astro Forms Skill

Server-side form handling for lead generation sites on Cloudflare Workers.

Scope

This skill covers the backend pipeline: validation → spam check → storage → email → redirect → analytics. For form UI components, field layout, and styling see the project's frontend patterns. The one exception is modifiers.md which documents common form layout variants for reference.

Implementation Sequence

When building a form, follow this order:

1. Define the schema — references/schemas.md → copy + adapt Zod schema
2. Copy boilerplate — assets/boilerplate/lib/ → into src/lib/forms/
3. Configure Worker — wrangler.toml with KV binding, wrangler secret put for all secrets
4. Set up Google Sheet — create service account, share sheet, add column headers (row 1)
5. Wire frontend — form posts to /api/submit, includes Turnstile + honeypot + hidden fields
6. Test locally — wrangler dev, submit form, check email + Sheets
7. Deploy — wrangler deploy