Using FormBeep with GitHub Pages#

GitHub Pages is ideal for portfolios, documentation, and student projects. Since GitHub Pages serves pure static files, you can’t run a backend to process forms. FormBeep solves this by routing submissions directly to your WhatsApp!

Step 1: Add Allowed Domain#

1. Go to your FormBeep Dashboard → Domains.
2. Add your GitHub Pages URL (e.g., yourusername.github.io).
3. Make sure to omit https:// and any trailing path.

Step 2: Add Embed Script#

In your repository, open the HTML file where you want the form (e.g., index.html or contact.html). Add the FormBeep script right before the closing </body> tag:

<script src="https://api.formbeep.com/v1/s/formbeep.js"
        data-api-key="YOUR_API_KEY"></script>

Step 3: Create the Form#

Create a standard HTML form. No messy JavaScript or API calls required on your end:

<form id="contact-form">
  <input name="name" type="text" placeholder="Your name" required>
  <input name="email" type="email" placeholder="you@example.com" required>
  <textarea name="message" placeholder="Your message" required></textarea>
  <button type="submit">Send Message</button>
</form>

Commit and push your changes. Wait a minute for the GitHub Action to deploy your site, then test your form on the live site!