https://github.com/taylow/freeformed

A simple, open source web form processor written in Go + HTMX + Tailwind
https://github.com/taylow/freeformed

docker docker-compose golang htmx postgresql tailwind

Last synced: 6 months ago
JSON representation

A simple, open source web form processor written in Go + HTMX + Tailwind

• Host: GitHub
• URL: https://github.com/taylow/freeformed
• Owner: taylow
• Created: 2024-04-03T18:58:00.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-04T08:52:14.000Z (over 2 years ago)
• Last Synced: 2024-04-04T20:44:42.306Z (about 2 years ago)
• Topics: docker, docker-compose, golang, htmx, postgresql, tailwind
• Language: Go
• Homepage:
• Size: 75.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  

 



Freeformed - An open source HTML form processing service!




[![Status](https://img.shields.io/badge/status-active-success.svg)]()

[![GitHub Issues](https://img.shields.io/github/issues/taylow/freeformed.svg)](https://github.com/taylow/freeformed/issues)

[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/taylow/freeformed.svg)](https://github.com/taylow/freeformed/pulls)



---

Note: This project is very early in development and should not be used in production until this message is removed.

## Features

✅ Implemented

- 🗄️ URL-encoded form data handling and storage - Handle and store arbitrary form data without having to pre-configure the expected data

- 🗄️ Multipart-form data and file handling and storage - Handle and store multipart-form with or without attached files

- 🗄️ JSON handling and storage - Handle and store json data

- 💾 Postgres storage - Store data to a postgres database

- 💾 S3 storage - Store files to an S3-compatible object store, such as MinIO, etc.

💡 Upcoming

- 🕹️ Dashboard - Create/edit forms, view/delete submissions, configure data sources, all from the comfort of your browser

- 🖥️ CLI/TUI - Host a minimal version of the form through CLI/TUI for quick and easy form processing

- ⚓️ Docker Compose stack - A full-feature docker-compose stack

- 🗄️ Supabase/Firebase/Pocketbase Support - For quick and easy hosting without the complexity of hosting an entire docker stack  

- 📧 Email forwarding - Forward form submissions directly to various email addresses

- 🪝 3rd party integrations - Forward your data to various sources, such as Slack, Discord, and Webhooks

- 🏁 Origin protection - Prevent other sites and bots from using your form URL

- 🤖 Spam protection - Use a mix of methods such as hidden field, origin, and ML to detect and categorise spam form submissions

- 🏗️ Form Builder/Expected Data - Build a form before wth the built in form builder and prevent data outside defined structure

- 🎨 View Builder - Choose from a range of views, from the default data grid, to customised charts

## How it Works

Simply use the generated URL in your form's `action` attribute, along with the `POST` method and the data and files will be stored in the storage of choice.

When you submit data through your form, the data will be available via a simple, yet customisable, dashboard.

## Stack

Freeformed is written in Go + HTMX, with SQL, HTML, and Tailwind to support.