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 and analytics alongside it.

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

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 analytics 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 Pro: $29/month for 100 projects and unlimited submissions. Total: $0/month with a public repo. Scale to 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. Forms, Pages, Analytics, Webhooks, Automations — all through 67 MCP tools and one REST API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Use any one feature or all of them together.

Pages

Deploy HTML instantly

Forms

Collect structured data

Automations

DSL-based pipelines with 14 step types

Analytics

Privacy-first, no cookies

Webhooks

Slack, Discord, Telegram

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 anything — a page, form, automation, or analytics site

# Create a form
curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "waitlist", "fields": [{"name": "email", "label": "Email", "type": "email", "required": true}]}'

# Or deploy a page
curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"slug": "index", "title": "My Site", "html": "<h1>Live</h1>"}'

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