FormFlow

An AI-powered form builder for creating forms, collecting responses, and generating insights from submitted data.

FormFlow combines a FastAPI backend, React frontend, SQLite storage, and AI-generated summaries into a lightweight, self-contained application. Create a form, share it through a public link, collect email-gated responses, and instantly generate a structured summary of all submissions.

Features

Form Creation

Build forms with support for multiple field types:

• Short Text
• Long Text
• Number
• Email
• Yes / No
• Rating (1–5)

Each form includes a title, description, and customizable set of questions.

Public Form Sharing

Every form receives a unique public URL that can be shared with respondents without requiring authentication.

Response Collection

Responses are stored in SQLite and associated with a respondent email address.

• One submission per email
• Duplicate response prevention
• Structured response storage

AI-Powered Summaries

Generate concise summaries across all responses for a form.

The AI summary highlights:

• Recurring themes
• Common requests
• Frequently reported issues
• Overall sentiment
• Actionable insights

Response Management

View all submissions from a dedicated dashboard with expandable respondent details and answer breakdowns.

Example Workflow

1. Create a form
2. Share the generated link
3. Collect responses
4. Review submissions
5. Generate an AI summary

Technology Stack

Layer	Technology
Frontend	React 18, Vite
Styling	Tailwind CSS
Backend	FastAPI, Uvicorn
Database	SQLite
AI	GROQ API

Architecture

React Client
      │
      ▼
   FastAPI
      │
      ▼
    SQLite
      │
      ▼
   GROK API

Project Structure

formflow/
├── backend/
│   ├── main.py
│   ├── requirements.txt
│   └── formflow.db
│
├── frontend/
│   ├── src/
│   │   ├── pages/
│   │   ├── components/
│   │   ├── api.js
│   │   ├── App.jsx
│   │   └── main.jsx
│   │
│   ├── package.json
│   ├── vite.config.js
│   └── tailwind.config.js
│
├── start.bat
└── README.md

Quick Start

Configure Environment

export GROQ_API_KEY=<your-api-key>

Manual Setup

Backend:

cd backend
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

Frontend:

cd frontend
npm install
npm run dev

Application:

Frontend: http://localhost:5173
Backend:  http://localhost:8000
Docs:     http://localhost:8000/docs

API

Method	Endpoint	Description
GET	/forms	List forms
POST	/forms	Create form
GET	/forms/{id}	Get form
DELETE	/forms/{id}	Delete form
POST	/forms/{id}/responses	Submit response
GET	/forms/{id}/responses	Get responses
POST	/forms/{id}/summary	Generate AI summary

Future Enhancements

• User authentication
• Form templates
• CSV export
• Analytics and visualizations
• Team collaboration
• Conditional logic
• PostgreSQL support
• Multi-page forms