1.0.6 • Published 2 years ago

serverless-form v1.0.6

Weekly downloads
2
License
GPL
Repository
github
Last release
2 years ago

Serverless Forms

This project is made for those who need to add custom HTML forms a static page or static website.

It is a simple nodejs server which forwards all POST submission by email. Inspired by the excellent formspree with the goal to be simpler to install and cheaper to host. No database, 100% server (nodejs), just sends the submissions by email.

Suggestion: you can automate the management of the subissions with tools like Huginn, node-red, IFTTT, Zappier

Links:

1 click deploy

Deploy in 1 click on heroku

Deploy in 1 click

Local install and use

1- type these 2 commands

$ npm install
$ EMAIL_USER="me@myemail.com" \
  EMAIL_PASS="abcd" \
  EMAIL_HOST="mail.gandi.net" \
  EMAIL_PORT=587 \
  TO="my.name@gmail.com" \
  npm start

2- Open http://localhost:8080 to see the HTML form which resides in form.html. Submit the form and it will send you an email with the content of the form.

3- You can customize the form, it will keep sending you all the field of the form by email.

Config

Here are all the environment variables you can use

Env vardescription
MESSAGEMessage to displayed after the form submission. May contain HTML. Default: 'Thank you for your submission.'
TOEmail address to send the form to (your email)
FROMEmail address to use as sender address
SITE_NAMEName of your site, will be displayed in the email title
PORTPort to listen to for form submissions
FORMPath to the HTML file containing the example form, defaults to ./form.html
EMAIL_HOSTSMTP config: see these options here
EMAIL_PORTSMTP config: see these options here
EMAIL_USERSMTP config: see these options here
EMAIL_PASSSMTP config: see these options here