Real email capture integration

Formspree Setup for the AI Coding Checklist

This guide explains how to connect the checklist form to Formspree while keeping the static GitHub Pages site safe when no endpoint is configured.

Setup steps

  1. Create or log in to a Formspree account.
  2. Create a new form for the AI Coding Workflow Checklist.
  3. Copy the Formspree endpoint URL.
  4. Open config/email_capture.json.
  5. Set provider to formspree.
  6. Paste the endpoint into form_endpoint.
  7. Change enabled to true.
  8. Run python main.py and python scripts/sync_site_output_to_docs.py.
  9. Commit and push the updated static files.
  10. Test a real email submission from the live checklist page.

Current safety rule

If enabled=false or form_endpoint is empty, the form remains in setup mode and does not submit anywhere.

FAQ

Do I need an API key in the HTML?

No. With Formspree, the static site only needs the public form endpoint. Do not put private API keys or tokens into HTML.

When does the form start collecting real emails?

Only when config/email_capture.json has enabled=true and form_endpoint contains your real Formspree endpoint.

What happens when the endpoint is empty?

The form stays in setup mode, does not POST anywhere, and does not pretend to save subscribers.

CTA

After adding a real endpoint, rebuild the static site before testing.

Open the checklist form