Go to file
formsdev 1d5c6f4895
Feature: Delete submission (#137)
* Feature: Delete submission

* Small polishing

---------

Co-authored-by: Julien Nahum <julien@nahum.net>
2023-06-30 15:53:04 +02:00
.github/workflows Enable auto-deploy 2023-03-26 12:54:39 +02:00
app Feature: Delete submission (#137) 2023-06-30 15:53:04 +02:00
bootstrap Initial commit 2022-09-20 21:59:52 +02:00
config Block Temporary mail addresses (#116) 2023-04-28 11:37:39 +02:00
database Confetti on form submission (#113) 2023-04-12 13:17:05 +02:00
public Embed form as popup (#124) 2023-05-19 16:06:48 +02:00
resources Feature: Delete submission (#137) 2023-06-30 15:53:04 +02:00
routes Feature: Delete submission (#137) 2023-06-30 15:53:04 +02:00
storage Block Temporary mail addresses (#116) 2023-04-28 11:37:39 +02:00
tests Safer slugs (#135) 2023-06-19 14:50:31 +02:00
.babelrc Initial commit 2022-09-20 21:59:52 +02:00
.editorconfig Initial commit 2022-09-20 21:59:52 +02:00
.env.docker Add database port to docker env, and fix jwt command 2023-03-23 14:46:36 +01:00
.env.example Fix name of app on fresh install 2023-04-12 16:03:23 +02:00
.eslintrc.js Initial commit 2022-09-20 21:59:52 +02:00
.gitattributes Initial commit 2022-09-20 21:59:52 +02:00
.gitignore Add docker compose setup (#73) 2023-02-22 19:13:32 +01:00
.styleci.yml Initial commit 2022-09-20 21:59:52 +02:00
LICENSE Changing license to AGPL 2022-09-20 22:03:59 +02:00
Makefile Add database port to docker env, and fix jwt command 2023-03-23 14:46:36 +01:00
README.md Add docker compose setup (#73) 2023-02-22 19:13:32 +01:00
artisan Initial commit 2022-09-20 21:59:52 +02:00
composer.json Block Temporary mail addresses (#116) 2023-04-28 11:37:39 +02:00
composer.lock Block Temporary mail addresses (#116) 2023-04-28 11:37:39 +02:00
docker-compose.yml Add docker compose setup (#73) 2023-02-22 19:13:32 +01:00
package-lock.json Update package-lock 2023-04-12 13:48:19 +02:00
package.json QR code on share url (#114) 2023-04-12 13:17:39 +02:00
php-cli.Dockerfile Add docker compose setup (#73) 2023-02-22 19:13:32 +01:00
phpunit.xml Fix JS middlewares ⚒️ 2023-01-27 18:55:02 +01:00
postcss.config.js Migrate to Vite (#71) 2023-01-21 12:57:37 +01:00
server.php Initial commit 2022-09-20 21:59:52 +02:00
tailwind.config.js Migrate to Vite (#71) 2023-01-21 12:57:37 +01:00
vapor.yml Block Temporary mail addresses (#116) 2023-04-28 11:37:39 +02:00
vite.config.js Embed form as popup (#124) 2023-05-19 16:06:48 +02:00

README.md

OpnForm

Build Status

An open-source form builder. It's an alternative to products like Typeform, JotForm, Tally etc.

Features

  • No-code form builder, with infinite number of fields & submissions
  • Text inputs, Date inputs, URL inputs, Phone inputs, Email inputs, Checkboxes, Select and Multi-Select inputs, Number Inputs, Star-ratings, File uploads & more
  • Embed anywhere (on your website, in your Notion page, etc)
  • Email notifications (for both form owner & form respondents)
  • Hidden fields
  • Form passwords
  • URL form pre-fill
  • Slack integration
  • Webhooks
  • Form logic
  • Customize colors, add images or even some custom code
  • Captcha form protection
  • Form closing date
  • Limit the number of submissions allowed

And much more!

Getting started with OpnForm

The easiest way to get started with OpnForm is with the official managed service in the Cloud.

It takes 1 minute to try out the builder for free. You'll have high availability, backups, security, and maintenance all managed for you.

Requirements

  • PHP >= 8.0
  • MySQL/MariaDB or PostgreSQL
  • Node.js and NPM/Yarn/... to compile assets

Installation

Docker installation 🐳

There's a docker compose setup automating most of the manual steps:

make up

The application is now running on http://localhost:4000. Alternatively, you may use the compose setup on its own

# Start the application
docker compose up -d server

# Run php commands, for example
docker compose run php-cli artisan about

# ...or update npm dependencies
docker compose run node-cli npm ci

make keeps track of all executed targets using .make.* files. In case you'd like to start from scratch (re-install dependencies, reset jwt token, run migrations, ...), run

make clean

After that, make will re-execute all targets upon the next execution.

Using Laravel Valet

This section explains how to get started locally with the project. It's most likely relevant if you're trying to work on the project. First, let's work with the codebase and its dependencies.

# Get the code!
git clone git@github.com:JhumanJ/OpnForm.git && cd OpnForm

# Install PHP and JS dependencies
composer install && npm install

# Compile assets (see the scripts section in package.json)
npm run dev # or build

Now, we can configure Laravel. We just need to prepare some vars in our .env file, just create it with cp .env.example .env then open it!

Configure the desired database in the DATABASE_ section. You can fine tune your installation on the laravel documentation.

Run these artisan commands:

# Generate needed secrets 🙈
php artisan key:generate
php artisan jwt:secret # and select yes!

# Creates DB schemas
php artisan migrate

Now, create an S3 bucket (or equivalent). Create an IAM user with access to this bucket, fill the environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, AWS_BUCKET. In your AWS bucket permissions, add the following under "Cross-origin resource sharing (CORS)":

[ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "PUT", "POST", "GET", "DELETE" ], "AllowedOrigins": [ "*" ], "ExposeHeaders": [] } ]

🎉 Done! Enjoy your personal OpnForm instance at: http://opnform.test.

Tech Stack

OpnForm is a standard web application built with:

Contribute

You're more than welcome to contribute to this project. We don't have guidelines on this yet, but we will soon. In the meantime, feel free to ask any question here.

License

OpnForm is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find it here.