Contact form

GitHub Pages can’t receive form messages, so the form posts to a form service that emails them to you. Alcor works with two, both with free plans. The form needs no JavaScript.

Web3Forms

1. Go to web3forms.com, enter your email address and get your access key.
2. In _config.yml:

alcor:
  form:
    provider: web3forms
    access_key: your-access-key
    subject: New message from your website

Messages arrive by email, and visitors land on your /thank-you/ page. The access key only lets people send messages to you, so it’s safe in a public repository.

Formspree

1. Create a form at formspree.io and copy its address (https://formspree.io/f/abcdwxyz).
2. In _config.yml:

alcor:
  form:
    provider: formspree
    endpoint: https://formspree.io/f/abcdwxyz
    subject: New message from your website

On Formspree’s free plan, visitors see Formspree’s own thank-you page. Paid plans can send them back to yours.

What the form sends

Name, email, message, and the budget if your contact section lists budgets. All fields except the budget are required, and the browser checks the email address before sending.

Both services also get a hidden spam-trap field that people never see and bots fill in.

The demo setting

provider: demo sends nothing: the form goes straight to the thank-you page and nothing a visitor types leaves the page. It’s what the demo site uses. Change it before you launch, or visitors’ messages will be lost.

The thank-you page

Edit thank-you.html to change the message. It’s hidden from search engines.