FormLoom

Docusaurus support ticket form

A structured support request with priority and attachments.

Recommended fields

FieldTypeRequired
nametextYes
emailemailYes
priorityselectYes
subjecttextYes
descriptiontextareaYes
attachmentfileNo

The code

Create a React component (or inline it in MDX) with an `onSubmit` that fetches FormLoom. Use it on a custom `/contact` page or in a doc.

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>
        Name
        <input type="text" name="name" required />
      </label>
      <label>
        Email
        <input type="email" name="email" required />
      </label>
      <label>
        Priority
        <select name="priority" required>
          <option value="Low">Low</option>
          <option value="Normal">Normal</option>
          <option value="High">High</option>
          <option value="Urgent">Urgent</option>
        </select>
      </label>
      <label>
        Subject
        <input type="text" name="subject" required />
      </label>
      <label>
        Describe the issue
        <textarea name="description" required></textarea>
      </label>
      <label>
        Attachment
        <input type="file" name="attachment" />
      </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 = {
  name: string;
  email: string;
  priority: string;
  subject: string;
  description: string;
  attachment?: 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({
  name: form.name.value,
  email: form.email.value,
  priority: form.priority.value,
  subject: form.subject.value,
  description: form.description.value,
  attachment: form.attachment.value,
});
AJAX fetch (vanilla JS)
contact.html
<form id="contact-form">
  <label>
    Name
    <input type="text" name="name" required />
  </label>
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <label>
    Priority
    <select name="priority" required>
      <option value="Low">Low</option>
      <option value="Normal">Normal</option>
      <option value="High">High</option>
      <option value="Urgent">Urgent</option>
    </select>
  </label>
  <label>
    Subject
    <input type="text" name="subject" required />
  </label>
  <label>
    Describe the issue
    <textarea name="description" required></textarea>
  </label>
  <label>
    Attachment
    <input type="file" name="attachment" />
  </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 file attachment so users can include screenshots (FormLoom supports up to 25MB on Pro).
  • Forward to your helpdesk via webhook to auto-create tickets.

FAQ

Yes — FormLoom supports 10MB file uploads on the free tier; add a `file` input.
Docusaurus support ticket form — copy-paste code + live demo · FormLoom