TiloBox
Back to directory
HeyForm project preview

HeyForm

Open-source form builder for creating surveys, quizzes, polls, and payments.

LicenseAGPL-3.0
GitHub stars8.9k
Last commit1 weeks ago
Tags6 topics
SurveysForm BuilderNodejsConversationalSelf HostedTypeform Alternative
Overview

Why consider HeyForm?

HeyForm is an open-source form builder with a conversational form interface. It supports logic branching, file uploads, integrations with Zapier and Slack, and payment collection via Stripe.

Guided learning

Learn HeyForm by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

3 min read 10 sections
In this guide10 sections

What is HeyForm?

HeyForm is an open-source, conversational form builder developed with Node.js, TypeScript, and React. It operates as a modern, self-hosted alternative to commercial form SaaS platforms like Typeform, JotForm, and Google Forms.

HeyForm renders surveys and questionnaires as fluid conversational flows, presenting one question at a time in a mobile-optimized, engaging interface. It supports advanced form logic (skip logic, conditional branching, question piping), 30+ question field types, file uploads, digital signatures, and Stripe payment collection.

Who Is It For?

  • Product & Marketing Teams: Gathering product feedback, NPS surveys, and lead generation forms with high response completion rates.
  • Event Organizers: Collecting participant registrations with payment collection and conditional field logic.
  • HR & Operations Teams: Deploying onboarding questionnaires, employee satisfaction surveys, and internal request forms.

Key Features

  • Conversational form interface: Mobile-first, one-question-at-a-time presentation for higher survey completion rates.
  • Advanced logic and branching: Skip, show, or hide questions based on prior answers using conditional rules.
  • 30+ field types: Short text, long text, multiple choice, ratings, rankings, file upload, signature, date, and payment.
  • Native integrations: Connect submissions to Google Sheets, Airtable, Slack, Zapier, Mailchimp, and webhook endpoints.
  • Stripe payment collection: Accept credit card payments directly within form submission flows.

Deploying HeyForm with Docker Compose

yaml
1version: '3.7'
2
3services:
4 mongo:
5 image: mongo:6-jammy
6 container_name: heyform_mongo
7 restart: unless-stopped
8 volumes:
9 - ./mongo_data:/data/db
10
11 redis:
12 image: redis:7-alpine
13 container_name: heyform_redis
14 restart: unless-stopped
15
16 app:
17 image: heyform/community-edition:latest
18 container_name: heyform_app
19 restart: unless-stopped
20 ports:
21 - "8000:8000"
22 environment:
23 - APP_HOMEPAGE_URL=http://localhost:8000
24 - MONGODB_URI=mongodb://mongo:27017/heyform
25 - REDIS_URI=redis://redis:6379
26 - SESSION_SECRET=generate_a_secure_random_session_secret
27 depends_on:
28 - mongo
29 - redis

Start the instance:

bash
1docker compose up -d

Navigate to http://localhost:8000 in your browser to register your account and build your first form.

Practical Use Cases

1. High-Engagement Product Feedback Survey

A product team embeds a HeyForm conversational survey on their app dashboard; the one-at-a-time question flow achieves 45% higher completion rates versus traditional multi-field forms.

2. Gated Lead Generation Form with Email Automation

A marketing team creates a lead capture form that triggers a Mailchimp email sequence when a contact submits their email address.

3. Event Registration with Stripe Payment

A conference organizer collects attendee registration details and processes ticket fees in a single form, with conditional logic routing speakers to a different question flow.

Troubleshooting and Limitations

  • MongoDB Connection String: Ensure the MONGODB_URI uses a reliable, persistent MongoDB container name or external Atlas cluster; HeyForm stores all form definitions and responses in MongoDB.
  • Webhook Delivery Timeouts: When configuring webhook integrations for form submission forwarding, ensure the receiving endpoint responds within 10 seconds to prevent delivery retries.

Official Resources

Related tools

More options with a similar category or technology profile.

HeyForm FAQs

HeyForm is listed as a Productivity tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

HeyForm is listed under the AGPL-3.0 license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

HeyForm is listed as an alternative to Google Forms. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.