ConvoForm

Turn Forms into Conversations with AI

Documentation

🚀 About

ConvoForm transforms traditional, static forms into interactive, AI-powered conversational experiences. It makes data collection engaging and intuitive—like talking to a human, but scalable.

Key Features

• AI-Powered Generation: Describe your needs, and let AI build the form for you.
• Conversational Interface: Users answer questions in a chat format rather than filling out input fields.
• Smart Validation: AI validates responses in real-time and asks follow-up questions if needed.
• Real-Time Editor: See changes instantly as you edit your form.
• Customizable: Brand your submission pages to match your identity.

📚 Documentation

Visit our Documentation Site for detailed guides, concepts, and API references.

• Getting Started / Self Hosting
• Conversation Flow Concepts

🛠️ Quick Start (Local Development)

Prerequisites

• Node.js (v18+)
• pnpm (v8+)
• Docker (optional, for self-hosting)

Installation

1. Clone the repo

   git clone https://github.com/growupanand/ConvoForm.git
   cd ConvoForm

2. Install dependencies

   pnpm install

3. Configure Environment

   cp .env.example .env
   # Update .env with your API keys (OpenAI, Clerk, etc.)
   # IMPORTANT: generate a strong ENCRYPTION_KEY for securing integration tokens.
   # You can generate one using `openssl rand -hex 32`

4. Run Development Server

   pnpm run dev

Visit http://localhost:3000 for the web app, http://localhost:3001 for the documentation, and http://localhost:4001 for the channels server (Telegram webhooks).

🤝 Contributing

We love contributions! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

📄 License

This project is open-sourced under the Apache License 2.0.