Stacks/Sutrena + GitHub Pages

Sutrena + GitHub Pages

Push HTML to GitHub. Sutrena handles the forms. That is the whole stack.

Updated March 2026

What is GitHub Pages?

GitHub Pages serves static sites from a repo. Free: 1 GB storage, 100 GB bandwidth/month. Custom domains, HTTPS, and Jekyll builds are included. You can also deploy pre-built sites from a branch or GitHub Actions. But there is a catch: it is not meant for commercial use. GitHub's terms say so explicitly.

How Sutrena fits

Sutrena Pages deploy HTML directly via the API or MCP tools — multi-page sites, custom domains, CDN assets. No Git repo needed. For teams that want Git-based version control and Jekyll builds, GitHub Pages is an option, and Sutrena handles forms alongside it.

With GitHub Pages: push HTML to GitHub, embed Sutrena forms, Sutrena handles validation, storage, spam protection, and dashboards.

With Sutrena alone: POST HTML to the API, site is live. No Git, no build step, no CI/CD. If you do not need version-controlled deployments, Sutrena Pages is simpler and includes forms and dashboards in one platform.

Example

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>My Project -- Contact</title>
  <style>
    * { box-sizing: border-box; }
    body { font-family: system-ui, sans-serif; max-width: 520px; margin: 3rem auto; padding: 0 1rem; }
    label { display: block; margin-top: 1rem; font-size: 0.875rem; }
    input, textarea, select { display: block; width: 100%; padding: 0.5rem; margin-top: 0.25rem; border: 1px solid #ccc; border-radius: 4px; }
    button { margin-top: 1.5rem; padding: 0.75rem 2rem; background: #111; color: #fff; border: none; border-radius: 4px; cursor: pointer; }
    button:hover { background: #333; }
    #success { display: none; padding: 1rem; background: #f0fdf4; border: 1px solid #bbf7d0; border-radius: 4px; }
  </style>
</head>
<body>
  <h1>Get in touch</h1>

  <div id="success">
    <p>Thanks for reaching out! We will reply within 24 hours.</p>
  </div>

  <form id="contact-form">
    <label for="name">Name</label>
    <input id="name" name="name" required />

    <label for="email">Email</label>
    <input id="email" name="email" type="email" required />

    <label for="subject">Subject</label>
    <select id="subject" name="subject" required>
      <option value="">Choose a topic</option>
      <option value="General">General inquiry</option>
      <option value="Support">Support</option>
      <option value="Partnership">Partnership</option>
    </select>

    <label for="message">Message</label>
    <textarea id="message" name="message" rows="5" required></textarea>

    <button type="submit">Send Message</button>
  </form>

  <script>
    document.getElementById("contact-form")
      .addEventListener("submit", async (e) => {
        e.preventDefault();
        const data = Object.fromEntries(new FormData(e.target));
        const res = await fetch(
          "https://sutrena.com/api/forms/frm_your_id/submit",
          {
            method: "POST",
            headers: { "Content-Type": "application/json" },
            body: JSON.stringify(data),
          }
        );
        if (res.ok) {
          e.target.style.display = "none";
          document.getElementById("success").style.display = "block";
        }
      });
  </script>
</body>
</html>

Cost

GitHub Pages: free for public repos. Private repos need a paid GitHub plan (Pro at $4/month). Sutrena Free: $0/month for 10 projects. Sutrena Builder: $9/month for 50 projects, 5,000 submissions per form. Sutrena Pro: $29/month for 200 projects. Total: $0/month with a public repo. Scale to Builder ($9/month) or Pro ($29/month) when you need more.

Caveat

GitHub Pages is not for commercial use. Their Terms of Service say so. If you are building something that makes money, use Cloudflare Pages instead -- it is also free and explicitly allows commercial projects.

FAQ

Can I use GitHub Pages for a commercial project?

GitHub discourages it. Their ToS prohibit using Pages for commercial transactions. Use Cloudflare Pages instead -- free and commercial-friendly.

Do I need Jekyll for Sutrena integration?

No. Plain HTML files work fine. Push them to a branch, configure Pages to serve from it. No build step needed.

How do I set up a custom domain?

Add a CNAME file to your repo root with your domain. Set a CNAME DNS record pointing to your-username.github.io. SSL is automatic.

What is the bandwidth limit?

100 GB/month. Enough for most personal and project sites. If you need more, Cloudflare Pages has unlimited bandwidth for free.

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'

Ready to build?

Get a trial API key instantly with no signup, or create an account for the full experience.

Sutrena + GitHub Pages -- Static hosting with form backends | Sutrena