Open-source form builder inspired by Typeform - beautiful, conversational forms made simple.

OpenFormy is a modern, open-source alternative to Typeform and Google Forms. Built on the powerful Pagode framework, it combines the speed and type-safety of Go with the flexibility of React to deliver beautiful, engaging forms.

• 🎨 Conversational & Traditional Modes - Choose between one-question-at-a-time (Typeform-style) or traditional multi-field forms
• 🎨 Auto Brand Color Extraction - Automatically extract and apply your brand colors from any website URL
• ⚡ Lightning Fast - Built on Go + Echo for blazing-fast performance
• 🔐 Secure by Default - Session-based authentication, CSRF protection, rate limiting
• 📊 Response Analytics - View, filter, and analyze form submissions with ease
• 🎯 Rich Question Types - Text, email, number, dropdown, checkboxes, date, file upload, and more
• 🌐 Public Sharing - Share forms via unique URLs with published/draft status control
• 💾 Simple Database - SQLite for easy setup and portability
• 🎭 Auto-Generated Admin Panel - Manage all entities through built-in admin interface
• 🔄 Hot Reload Development - Fast development workflow with Air

Backend:

• Go 1.24 with Echo v4 web framework
• Ent ORM for type-safe database operations
• SQLite with WAL mode for concurrent access
• InertiaJS for seamless frontend-backend communication

Frontend:

• React 19 with TypeScript
• Tailwind CSS v4 for styling
• shadcn/ui component library
• Vite for blazing-fast builds

• Go 1.24+
• Node.js 18+
• Make (optional but recommended)

# Clone the repository
git clone https://github.com/pansani/openformy.git
cd openformy

# Install backend dependencies
go mod download

# Install frontend dependencies
npm install

# Generate Ent code
make ent-gen

# Run the application
make run

The application will be available at http://localhost:8000

# Install Air (Go hot reload)
make air-install

# Start with hot reload
make watch

1. Register an account at /user/register
2. Create a form - Click "New Form" from the dashboard
3. Add questions - Drag question types from the sidebar
4. Choose display mode - Toggle between Conversational and Traditional
5. Publish - Toggle the Published switch
6. Share - Copy the public form URL and share it

Traditional Mode:

• All questions visible on one page
• Faster for short forms
• Familiar user experience

Conversational Mode:

• One question at a time
• Typeform-style experience
• More engaging for users
• Progress indicator and keyboard navigation

OpenFormy is built on Pagode, a full-stack Go + React starter kit. For detailed documentation on the underlying framework:

• 📖 Pagode Documentation
• 🏗️ Architecture Guide
• 🗄️ Database & ORM
• 🔐 Authentication
• ⚙️ Configuration

• CLAUDE.md - Development guide and architecture notes
• DEPLOYMENT.md - Production deployment guide for Coolify

# Run the application
make run

# Hot reload development
make watch

# Run tests
make test

# Generate Ent code (after schema changes)
make ent-gen

# Create new Ent entity
make ent-new name=EntityName

# Create admin user
make admin [email protected]

openformy/
├── cmd/                    # Application entry points
│   ├── web/               # Main web application
│   └── admin/             # Admin CLI tools
├── pkg/
│   ├── handlers/          # HTTP request handlers
│   ├── middleware/        # Custom middleware
│   ├── services/          # Business logic & service container
│   └── routenames/        # Route name constants
├── ent/
│   └── schema/            # Database entity schemas
├── resources/
│   └── js/
│       ├── Pages/         # InertiaJS page components
│       ├── components/    # Reusable React components
│       ├── hooks/         # Custom React hooks
│       └── types/         # TypeScript type definitions
├── config/                # Configuration files
└── static/                # Static assets

# Run all Go tests
make test

# Run E2E tests with Playwright
npx playwright test

# Run E2E tests in headed mode
npx playwright test --headed

# Run specific E2E test file
npx playwright test e2e/forms.spec.ts

# Run specific Go test
go test ./pkg/handlers -run TestForms

Deploy OpenFormy to production using Coolify with automatic Nixpacks builds.

1. Connect your Git repository to Coolify
2. Nixpacks will auto-detect and configure the build
3. Set required environment variables (see table below)
4. Deploy!

📖 Full Deployment Guide - Detailed instructions, database setup, troubleshooting, and more.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is open source and available under the MIT License.

OpenFormy is built with and inspired by many amazing open-source projects:

• Pagode - Full-stack Go + React starter kit

• Go - Programming language
• Echo - Web framework
• Ent - Entity framework & ORM
• SQLite - Database
• Air - Hot reload
• Backlite - Background job processing
• Viper - Configuration management

• React - UI library
• InertiaJS - SPA bridge (via gonertia)
• TypeScript - Type safety
• Tailwind CSS - Styling
• shadcn/ui - Component library
• Vite - Build tool
• Lucide - Icons

• Typeform - Conversational form UX
• ikiform - AI-powered features concept

• 📚 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

Built with ❤️ using Pagode