Skip to content

Introduction

Seaforms is a form builder. You, a colleague or a client build a form in the app at app.seaforms.io and publish it. These docs are for the developer who puts that form in a site built with code: React, Next.js, Astro, or a site an AI tool built.

A published form is a file: its questions, steps, logic and thank-yous as JSON, such as src/forms/contact.seaforms.json. Your site reads it while it builds, and @seaforms/react draws it.

  • In your page’s HTML. The form renders on your server as a real <form>. It works before JavaScript loads, then steps, logic and inline errors take over once it does.
  • No shift. Every step, message and price line has its room from the start, so nothing on the page moves.
  • Your site’s look. It ships as plain, accessible HTML that takes your CSS, or with our optional finished style.
  • Nothing fetched to draw it. The form’s structure is in your build. A visitor’s browser talks to Seaforms only to send.

You get the file one of two ways:

  1. Pull it. npx seaforms pull saves every published form of your site as a file, with its TypeScript types. Commit them, and pull again after each publish.
  2. Fetch it while you build. getForm from @seaforms/react/server fetches a form’s latest published version with an API key. Use it when someone else edits the form: they publish, and your next build has it.

Who’s emailed, which apps get the submission, spam settings and whether the form is open all live on our server. They change the moment someone saves them in the app, with no new file and no rebuild. Only changes to the questions, steps and logic need a publish.

  • Webhooks: each submission posted to your endpoint as JSON, signed so your code can tell it came from us.
  • The API: read submissions, mark spam, publish forms and change their settings from your own scripts, with an API key that does only what you tick.
  • The MCP connector: Claude Code, Cursor, VS Code, ChatGPT, Claude or any app that supports MCP can make and publish forms for you, on every plan.
  • The form format: what’s in a form’s file, and its JSON Schema.
Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks