Web Forms on steroids!
A powerful, modern form builder built on the Frappe Framework. Forms Pro takes Frappe web forms to the next level with an intuitive drag-and-drop interface, advanced field types, and seamless integration.
- 🎨 Modern Drag-and-Drop Builder - Intuitive visual form builder with real-time preview
- 📝 Rich Field Types - Support for Data, Number, Email, Date, DateTime, DateRange, TimePicker, Password, Select, Switch, Textarea, and Text Editor fields
- 🔗 Doctype Integration - Link forms to any Frappe DocType for seamless data management
- 👥 Team Collaboration - Built-in team support for multi-user form management
- 🔐 Access Control - Optional login requirements and permission management
- 💾 Save Progress - Allow incomplete submissions with save-and-continue functionality
- 🎯 Custom Routes - Publish forms with custom URLs for easy sharing
- 📱 Responsive Design - Beautiful, mobile-friendly forms that work everywhere
- ⚡ Real-time Updates - Built with Vue 3 and modern web technologies for smooth performance
Forms Pro is a Frappe app and can be installed using the bench CLI.
- Frappe Framework installed via bench
- Python 3.14 or higher
- Node.js and npm/yarn (for frontend development)
cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/buildwithhussain/forms_pro --branch develop
bench install-app forms_proFor development, you'll need to set up the frontend:
cd apps/forms_pro/frontend
yarn install
yarn dev # For development
yarn build # For production build- Create a Form: Navigate to Forms Pro in your Frappe desk
- Add Fields: Use the drag-and-drop builder to add and arrange form fields
- Configure Settings: Set up form title, description, linked doctype, and other settings
- Publish: Enable "Is Published" and set a custom route
- Share: Share your form URL with users
- Drag and Drop: Reorder fields by dragging them in the builder
- Field Properties: Customize each field's label, type, validation, and options
- Live Preview: See your form as you build it
- Rich Text Description: Add formatted descriptions using the text editor
- Backend: Python 3.14+, Frappe Framework
- Frontend: Vue 3, TypeScript, Vite
- UI Components: Frappe UI, Tailwind CSS
- Form Builder: Vue Draggable
- Validation: Zod
- Icons: Lucide Vue, Feather Icons
We welcome contributions! Forms Pro uses pre-commit for code formatting and linting.
Please review CONTRIBUTING.md for the contribution workflow and SECURITY.md for responsible disclosure.
-
Fork the repository and clone your fork
-
Install pre-commit:
cd apps/forms_pro pre-commit install -
Create a branch for your changes:
git checkout -b feature/your-feature-name
-
Make your changes and ensure they pass linting:
pre-commit run --all-files
-
Submit a pull request with a clear description of your changes
This project uses the following tools for code quality:
- ruff - Python linter and formatter
- eslint - JavaScript/TypeScript linter
- prettier - Code formatter
- pyupgrade - Python syntax upgrades
- biome - Fast formatter and linter for frontend
The project includes automated testing via GitHub Actions:
- CI: Installs the app and runs unit tests on pull requests and pushes to
develop - Linters: Runs Frappe Semgrep Rules and pip-audit on every pull request
This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.
- Harsh Tandiya - harsh@buildwithhussain.com
- BWH Studios - developers@buildwithhussain.com
- Built on the amazing Frappe Framework
- Inspired by the Frappe community's need for better form building tools
Made with ❤️ by BWH Studios