@formgong/vue

@formgong/vue

Contact forms for Vue 3 and Nuxt without a backend. Formgong delivers each submission to email, Telegram and webhooks. You don't need an API route, a database or SMTP.

npm install @formgong/vue

Ready-made form

<script setup>
import { ContactForm } from "@formgong/vue";
</script>

<template>
  <ContactForm access-key="fk_your_access_key" lang="en" @success="(r) => console.log(r.id)" />
</template>

Your own fields

<script setup>
import { FormgongForm } from "@formgong/vue";
</script>

<template>
  <FormgongForm access-key="fk_your_access_key" subject="New quote request" v-slot="{ submitting, error }">
    <input name="name" required />
    <input name="phone" type="tel" />
    <button :disabled="submitting">Send</button>
    <small v-if="error?.code === 'rate_limited'">Please wait a minute.</small>
  </FormgongForm>
</template>

<FormgongForm> adds the hidden access_key, _lang and _subject fields, a botcheck honeypot, the anti-spam signals (like Formgong's fg.js) and an aria-live status line. It emits success and error. Without JavaScript the form still posts natively.

Props: access-key (required), lang, subject, redirect, endpoint, anti-spam (default true), hide-status, status-class. ContactForm also takes labels.

Composable

<script setup lang="ts">
import { useFormgong } from "@formgong/vue";
const { formRef, handleSubmit, status, message, submitting, error, submit } = useFormgong({ accessKey: "fk_your_access_key" });
</script>

<template>
  <form ref="formRef" @submit="handleSubmit">
    <input name="email" type="email" required />
    <textarea name="message" required />
    <input name="botcheck" tabindex="-1" autocomplete="off" style="position:absolute;left:-10000px" />
    <button :disabled="submitting">Send</button>
    <p role="status">{{ message }}</p>
  </form>
</template>

submit(data) posts any object, for VeeValidate, FormKit or your own state. It never throws: check error (a typed FormgongError with code).

Nuxt

// plugins/formgong.client.ts
import Formgong from "@formgong/vue";
export default defineNuxtPlugin((nuxt) => nuxt.vueApp.use(Formgong)); // registers <FormgongForm> and <ContactForm>

Or run npx formgong init in a Nuxt project. It writes components/ContactForm.vue with a fresh form key. More: formgong.com/en/for/vue/ · formgong.com/en/for/nuxt/.

The access key (fk_…) is public by design: it can only send submissions to your form.

Why Formgong

Formgong is a hosted form backend with a free plan, built for static and AI-built sites. Submissions go to email and Telegram, plus webhooks for Make, n8n and Zapier. Data is stored in the EU, and messages and autoreplies come in 12 languages. Spam filtering includes a honeypot, optional Cloudflare Turnstile and cookie-free behaviour signals, with no stored fingerprints.

How it compares with Formspree, Web3Forms, Basin, Getform, FormSubmit and Netlify Forms: formgong.com/en/compare. Moving from Formspree takes one line: change the form action or the access key (guide).

Packages

Links

• Docs: https://formgong.com/en/docs/
• MCP server for Cursor, Claude and VS Code: https://formgong.com/en/docs/mcp/
• Source: https://github.com/formgong/js
• Issues: https://github.com/formgong/js/issues
• Support: support@formgong.com

License

MIT © Formgong