Eleventy bug report form
A structured bug report with steps and a screenshot.
Recommended fields
| Field | Type | Required |
|---|---|---|
| No | ||
| summary | text | Yes |
| steps | textarea | Yes |
| severity | select | No |
| screenshot | file | No |
The code
Add the HTML form to a template or include. Optionally enhance with a small script for an inline success state.
Plain HTML (no JavaScript)
contact.html
<form action="https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY" method="POST">
<label>
Email
<input type="email" name="email" />
</label>
<label>
Summary
<input type="text" name="summary" required />
</label>
<label>
Steps to reproduce
<textarea name="steps" required></textarea>
</label>
<label>
Severity
<select name="severity">
<option value="Cosmetic">Cosmetic</option>
<option value="Minor">Minor</option>
<option value="Major">Major</option>
<option value="Critical">Critical</option>
</select>
</label>
<label>
Screenshot
<input type="file" name="screenshot" />
</label>
<!-- honeypot: bots fill this, humans don't see it -->
<input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
<button type="submit">Send</button>
</form>AJAX fetch (vanilla JS)
contact.html
<form id="contact-form">
<label>
Email
<input type="email" name="email" />
</label>
<label>
Summary
<input type="text" name="summary" required />
</label>
<label>
Steps to reproduce
<textarea name="steps" required></textarea>
</label>
<label>
Severity
<select name="severity">
<option value="Cosmetic">Cosmetic</option>
<option value="Minor">Minor</option>
<option value="Major">Major</option>
<option value="Critical">Critical</option>
</select>
</label>
<label>
Screenshot
<input type="file" name="screenshot" />
</label>
<!-- honeypot: bots fill this, humans don't see it -->
<input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
<button type="submit">Send</button>
</form>
<script>
const form = document.getElementById("contact-form");
form.addEventListener("submit", async (e) => {
e.preventDefault();
const res = await fetch("https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY", {
method: "POST",
headers: { "Content-Type": "application/json", Accept: "application/json" },
body: JSON.stringify(Object.fromEntries(new FormData(form))),
});
const data = await res.json();
if (data.success) {
form.reset();
alert("Thanks — we got your message.");
} else {
alert(data.message || "Something went wrong.");
}
});
</script>@formloom/client (typed SDK)
submit.ts
// npm i @formloom/client
import { createForm } from "@formloom/client";
type Contact = {
email?: string;
summary: string;
steps: string;
severity?: string;
screenshot?: string;
};
const form = createForm<Contact>("YOUR_ACCESS_KEY");
// End-to-end typed: TS errors if you send the wrong shape.
const { success, message } = await form.submit({
email: form.email.value,
summary: form.summary.value,
steps: form.steps.value,
severity: form.severity.value,
screenshot: form.screenshot.value,
});Tips
- Allow a screenshot upload to speed up triage.
- Forward to GitHub Issues or Linear via a webhook.
FAQ
Yes — add a webhook that forwards the report JSON to a function that opens an issue.