MCPcopy Index your code
hub / github.com/heyform/heyform

github.com/heyform/heyform @v3.0.0-rc.9

repository ↗ · DeepWiki ↗ · release v3.0.0-rc.9 ↗ · Ask this repo → · + Follow
3,301 symbols 8,758 edges 751 files 5 documented · 0% updated 10d agov3.0.0-rc.9 · 2026-06-25★ 8,86415 open issues
README

heyform logo

Open-source form builder, built for small business success

Website | Documentation | Blog

heyform

HeyForm

Features

HeyForm simplifies the creation of conversational forms, making it accessible for anyone to gather information or feedback through engaging surveys, quizzes, and polls. We are committed to enhancing HeyForm with regular updates, including bug fixes, new features, and performance improvements.

Build Forms with Ease

  • Versatile Inputs: From basic text, email, and phone number fields to advanced options like picture choices, date pickers, and file uploads, HeyForm supports a wide array of input types.
  • Smart Logic: Conditional logic and URL redirections for dynamic, adaptable forms.
  • Powerful Integrations: Connect with webhooks, analytics, marketing platforms, and tools like Zapier and Make.com.

Customize to Your Brand

  • Visual Themes: Tailor the look and feel of your forms to match your brand identity with customizable fonts, colors, backgrounds, and more.
  • Advanced Theming: Gain greater control with extensive customization options, including custom CSS for deeper personalization.

Analyze and Act on Data

  • Insightful Analytics: Gain insights with detailed analytics, including drop-off rates and completion rates.
  • Data Export: Easily export your form results to CSV for further analysis or integration into your systems.

Getting started with HeyForm

The simplest and most efficient way to dive into HeyForm is through our official hosted service. When you choose this cloud version, you're getting the advantage of high reliability, automatic backups, robust security, and hassle-free maintenance—all carefully managed by us, the passionate duo behind HeyForm.

Choosing our hosted version not only saves a significant amount of time and resources but also supports HeyForm's development and the open-source community. Get a great service while backing innovation. 💙

Structure

.
└── packages
    ├── answer-utils       (form submission utils for server and webapp)
    ├── embed              (form embed javascript library)
    ├── form-renderer      (form rendering library)
    ├── shared-types-enums (shared types/enums for server and webapp)
    ├── utils              (common utils for server and webapp)
    ├── server             (node server)
    └── webapp             (react webapp)

Self-hosting

Interested in self-hosting HeyForm on your server? Take a look at the self-hosting installation instructions.

One Click Deployment

Deploy on Railway

Deploy on Zeabur

Deploy on Sealos

Deploy to RepoCloud

Deploy on Alibaba Cloud

Local development

Follow the local installation instructions to run the project locally.

How to Contribute

You are awesome, let's build great software together. Head over to the contribute docs to get started. 💪

Support & Community

You'll find a lot of resources to help you get started with HeyForm in the help center. However, if you can't find what you're looking for there, don't hesitate to reach out to us:

License

HeyForm is open-source under the GNU Affero General Public License v3.0 (AGPL-3.0), you will find more information about the license and how to comply with it here.

Extension points exported contracts — how you extend this code

LRUStore (Interface)
(no doc) [3 implementers]
packages/webapp/src/pages/form/Render/utils/lru.ts
LRUStore (Interface)
(no doc) [3 implementers]
packages/form-renderer/src/utils/lru.ts
ConnectOpts (Interface)
* Direct mongo writes used to bootstrap state the server has no public API * for. Right now that's just "join this user
packages/server/test/e2e/helpers/seed.ts
Options (Interface)
(no doc)
packages/utils/src/error.ts
GroupModel (Interface)
(no doc)
packages/shared-types-enums/src/audience.ts
HTMLWalkOptions (Interface)
(no doc)
packages/answer-utils/src/html-utils.ts
FullPageSettings (Interface)
(no doc)
packages/embed/src/type.ts
Window (Interface)
(no doc)
packages/webapp/src/vite-env.d.ts

Core symbols most depended-on inside this repo

map
called by 291
packages/embed/src/utils/dom.ts
useTranslation
called by 226
packages/form-renderer/src/utils/hook.ts
find
called by 126
packages/embed/src/utils/dom.ts
cn
called by 88
packages/webapp/src/utils/common.ts
onChange
called by 80
packages/webapp/src/components/Prompt.tsx
Auth
called by 76
packages/server/src/common/decorator/auth.decorator.ts
fieldValuesToAnswers
called by 62
packages/answer-utils/src/field-values-to-answer.ts
uniqueName
called by 54
packages/server/test/e2e/helpers/random.ts

Shape

Function 1,375
Class 758
Method 755
Interface 380
Enum 33

Languages

TypeScript100%

Modules by API surface

packages/server/src/common/graphql/form.graphql.ts126 symbols
packages/utils/src/error.ts75 symbols
packages/webapp/src/components/DatePicker.tsx52 symbols
packages/server/src/common/graphql/team.graphql.ts48 symbols
packages/webapp/src/services/integration.ts42 symbols
packages/webapp/src/services/form.ts39 symbols
packages/shared-types-enums/src/form.ts36 symbols
packages/server/src/utils/outbound-url.ts34 symbols
packages/utils/src/helper.ts30 symbols
packages/server/src/common/graphql/submission.graphql.ts30 symbols
packages/server/src/service/mail.service.ts29 symbols
packages/server/src/service/submission.service.ts27 symbols

Dependencies from manifests, versioned

@apollo/client3.11.8 · 1×
@apollo/server4.13.0 · 1×
@aws-sdk/client-s33.846.0 · 1×
@graphql-tools/utils10.9.1 · 1×
@heyform-inc/answer-utils1.2.0 · 1×
@heyform-inc/form-rendererworkspace:* · 1×
@heyform-inc/shared-types-enums1.1.8 · 1×
@heyform-inc/utils1.2.0 · 1×
@heyooo-inc/env0.0.1 · 1×
@nestjs/apollo12.2.2 · 1×

Datastores touched

(mongodb)Database · 1 repos
heyformDatabase · 1 repos

For agents

$ claude mcp add heyform \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact