Next.js 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
Define an inline `"use server"` action that forwards the FormData to your FormLoom endpoint. No client JS required — it works with JavaScript disabled and progressively enhances. For richer UIs, pair it with `useActionState` for pending/error states.
Server Action (recommended)
app/contact/page.tsx
// app/contact/page.tsx — Next.js 15 App Router, Server Action
export default function ContactPage() {
async function submit(formData: FormData) {
"use server";
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(formData)),
});
// FormLoom scores spam, stores the row, and emails you — no backend to wire.
return res.json();
}
return (
<form action={submit}>
<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>
);
}React component (client)
ContactForm.tsx
// ContactForm.tsx — React (works in Vite, CRA, Next 'use client')
"use client";
import { useState } from "react";
export function ContactForm() {
const [status, setStatus] = useState<"idle" | "ok" | "error">("idle");
async function onSubmit(e: React.FormEvent<HTMLFormElement>) {
e.preventDefault();
const form = e.currentTarget;
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))),
});
setStatus((await res.json()).success ? "ok" : "error");
if (status !== "error") form.reset();
}
if (status === "ok") return <p>Thanks — we got your message.</p>;
return (
<form onSubmit={onSubmit}>
<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>
);
}@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.