README
¶
Web Forms
WebForms is a versatile tool with a focus on DevOps compatibility, designed for creating HTML UI forms with backends that can be hosted in PostgreSQL, SQLite3, or plain JSON files. The service offers the flexibility to reuse existing tables and database structures and includes automated embedded schema migration.
The user interface (UI) is designed to be lightweight and mobile-friendly, and it can function without JavaScript, although there may be some limitations in timezone detection. The service also includes various security features. Additionally, there is an option to disable the UI for browsing available forms. The service also offers OIDC integration for authorization, with the ability to use OIDC claims, such as usernames, in templating and default values.
WebForms allows for the sending of multiple notifications ( ex: WebHooks or AMQP) after form submissions to facilitate integration with external systems. It provides a configurable retry strategy for reliability.
Flexible templating enables the prefilling of fields and the generation of personalized greeting messages.
The service optionally supports CAPTCHA for verifying the authenticity of incoming requests during both form submission and access code submission processes.
Initial setup of the service is straightforward and requires minimal backend configuration and form definition. However, for those who require more customization, almost every aspect of the service can be configured. It can be used in a stateless manner and is scalable. Refer to the production checklist for further details.
WebForms is available in various formats, including source code, pre-compiled binaries for major platforms, and containers for both AMD and ARM architectures.
The project is licensed under MPL-2.0 (Exhibit A), which allows for commercial usage with minimal restrictions, provided that any changes made are shared with the community. This promotes collaboration and community involvement.
Read docs for details: https://web-form.reddec.net/
Installation
- From source code using go 1.21+
go install github.com/reddec/web-form/cmd/...@latest - From binaries
- From containers - see docker
Examples
Check examples in corresponding directory.
Directories