formgong

Formgong CLI: create a form backend and add a working contact form to Next.js, React, Vue, Svelte, Astro or plain HTML in one command. Submissions go to email and Telegram. npx formgong init
504
vue react svelte cli forms astro nextjs mcp email form-builder gdpr ai-agents telegram no-backend formgong contact-form
Install
npm install formgong
Latest Version:0.2.0
License:MIT
Last Updated:Oct 3, 2026
Links: GitHub  ·  npm
Maintainer: formgong

formgong

npm CI license node

The Formgong CLI. A contact form backend from your terminal: create a form, drop a working contact page into Next.js, React, Vue, Nuxt, Svelte, SvelteKit, Astro, Angular or plain HTML, and read submissions. Submissions also go to your email and Telegram.

npx formgong login     # paste a personal API token (fgp_…)
npx formgong init      # create a form + write a contact page for your framework

Commands

Command What it does
login Saves a personal API token (create one under Dashboard → Account → API tokens). Input is hidden, and the token is checked against the API before it is saved to ~/.config/formgong/credentials.json (mode 600). It also takes --token, --stdin or FORMGONG_TOKEN.
logout Removes the saved token.
init Detects your framework and package manager, creates a form (or reuses one with --form <id> / --key fk_…), writes a contact page and installs the matching @formgong/* package.
forms Lists your forms: id, name, access key, submissions this month.
create <name> Creates a form (--no-email turns off email notifications).
snippet <form> Prints ready-to-paste, dependency-free code (--framework html|react|next, --lang uk).
submissions <form> Shows recent submissions (--limit 10, --spam). Field values are visitor data; control characters are stripped.
new [dir] Scaffolds a whole starter project (runs create-formgong).

<form> can be a form id, an access key (fk_…) or the exact form name. Add --json to any read command for machine-readable output (handy in CI or for AI agents).

What init writes

Detected File Package
Next.js (App Router) app/contact/page.tsx (or src/app/…) @formgong/react
Next.js (Pages) pages/contact.tsx @formgong/react
React / Vite / Lovable / Bolt src/components/ContactForm.tsx @formgong/react
Vue src/components/ContactForm.vue @formgong/vue
Nuxt components/ContactForm.vue @formgong/vue
SvelteKit src/routes/contact/+page.svelte @formgong/svelte
Svelte src/lib/ContactForm.svelte @formgong/svelte
Astro src/pages/contact.astro @formgong/astro
Angular 17+ src/app/contact/contact.component.ts (standalone, add a route) @formgong/angular
No framework contact.html (official snippet from the API) –

Useful flags:

  • --framework <name> overrides detection.
  • --snippet writes the dependency-free API snippet instead of a package import.
  • --lang uk sets the visitor language.
  • --name "Contact – acme.com" names the new form.
  • --dir writes into another folder.
  • --no-install skips the package install.
  • --dry-run shows what would be written.
  • --force overwrites existing files.

How it works

The CLI calls Formgong's account API, the same JSON-RPC endpoint the MCP server uses (https://formgong.com/mcp), with your personal token. The token never leaves your machine except in requests to that endpoint. Limits: 60 requests per minute per token and 10 new forms per hour. The form's access key (fk_…) written into your code is public by design.

Environment variables:

  • FORMGONG_TOKEN: token for CI. It takes priority over the saved token.
  • FORMGONG_API_URL: another API endpoint.
  • FORMGONG_CONFIG_DIR: where credentials are stored.
  • NO_COLOR: plain output.

Requires Node.js 18.17+. The CLI is a single bundled file with no dependencies to install.

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

Package What it is
@formgong/core Tiny typed client: submit(), typed errors, anti-spam tracker, account API
@formgong/react <ContactForm>, <FormgongForm>, useFormgong() for React, Lovable, Bolt and v0
@formgong/next Next.js Server Action and Route Handler helpers, plus App Router components
@formgong/vue Vue 3 and Nuxt components and the useFormgong() composable
@formgong/svelte use:formgong action, store helper, Svelte components
@formgong/astro Astro components with progressive enhancement, plus a helper for Actions
@formgong/angular Angular 17+ standalone component, formgongForm directive and FormgongService with signals
formgong CLI: npx formgong init creates a form and adds it to your project
create-formgong npm create formgong@latest: starter projects

Links

License

MIT © Formgong

Related Packages

@formgong/core

Tiny, typed, zero-dependency client for Formgong, the form backend for contact f...

232 0
astro bolt contact form contact-form email form backend form-backend formgong forms formspree alternative +22
@formgong/vue

Vue 3 / Nuxt contact form without a backend: , and useFormgong(). Submissions go...

157 0
bolt contact form contact-form email form backend form-backend formgong forms formspree alternative formspree-alternative +12
a11y-checker

Accessibility scanner for humans and AI agents: CLI, MCP server and skill that r...

36,659 117
ai-agents astro mcp nextjs react vue a11y accessibility angular axe-core +2
tally-embed

Framework-agnostic TypeScript library for embedding Tally.so forms with full typ...

1,584 1
astro form-builder forms react svelte vue embed framework-agnostic popup survey +5
exhuma

Universal Component CLI — Add tactile, headless components to any project across...

799 2
astro cli nextjs react svelte vue angular blade components exhuma +5

Version History

Version Released License
0.2.0 MIT
0.1.0 MIT
Pre-releases (1)
Version Released License
0.0.0-stage