FormLoom

VitePress bug report form

A structured bug report with steps and a screenshot.

Recommended fields

FieldTypeRequired
emailemailNo
summarytextYes
stepstextareaYes
severityselectNo
screenshotfileNo

The code

Register or import a Vue component and use it inside Markdown. The component fetches FormLoom on submit.

Vue 3 single-file component
ContactForm.vue
<!-- ContactForm.vue — Vue 3 / Nuxt 3 -->
<script setup>
import { ref } from "vue";
const status = ref("idle");
async function submit(e) {
  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(e.target))),
  });
  status.value = (await res.json()).success ? "ok" : "error";
}
</script>

<template>
  <p v-if="status === 'ok'">Thanks — we got your message.</p>
  <form v-else @submit.prevent="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>
</template>
@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,
});
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>

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.
VitePress bug report form — copy-paste code + live demo · FormLoom