HORM

Html form backend

Horm is basically a backend to help you manage multiple forms and their responses. It is super easy to set up/use and will help you save your HTML form responses on your own server.

Features

• Host on your own server
• REST APIs for interaction
• Admin user for all sensitive operations
• Create unlimited forms and entries
• Setup CORS your way (or keep it wildcard)
• Notification triggers on new record submission
  • Email
  • Webhook

Installation

Docker Compose

• Clone the project
• Setup .env file as mentioned in the ENV.docker.md file
• Start the service using docker-compose up
• Default credentials (admin token) will be printed in logs inside the app container

Building From Source

Pre-Requisites

• Clone the project
• Redis database (used for keeping track of sending/retrying notification)
• Postgres database (to save forms & records)
• Bun runtime installed (https://bun.com/)
• Setup .env file as mentioned in the ENV.md file

Getting Started

• Install dependencies by bun install --frozen-lockfile --production
• Start the server bun start
• On starting the server, default admin details will be printed on the console
• Use the token for all API operations

APIs

• OpenAPI file provided in openapi.yaml
• You can copy/paste it on Swagger Editor for the GUI view