PaperFreeForm - A Free Form Builder to save trees and create beautiful forms

PaperFreeForm

PaperFreeForm is a Free Form Builder to save trees and create beautiful forms. Easy online form builder that works like a doc. Just add form elements as you type and start collecting data. View Demo · Report Bug · Request Feature

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • npm
    npm install npm@latest -g

Installation

  1. Clone the repo

    git clone https://github.com/zaidmukaddam/paperfreeform.git
  2. Install NPM packages

    npm install
  3. Create a .env.local file and add your own variables

    # HarperDB
    HARPERDB_TOKEN=[Your HarperDB Authorization Token]
    HARPERDB_URL=https://example.harperdbcloud.com
    
    # Unsplash
    UNSPLASH_TOKEN=[Your Unsplash Access Key]
    UNSPLASH_API=https://api.unsplash.com
    
    # Auth0
    AUTH0_SECRET=[use [openssl rand -hex 32] to generate a 32 bytes value]
    AUTH0_BASE_URL=https://example.com
    AUTH0_ISSUER_BASE_URL=https://example.us.auth0.com
    AUTH0_CLIENT_ID=[Your Auth0 Client ID]
    AUTH0_CLIENT_SECRET=[Your Auth0 Client Secret]
  4. On harperdb you must create a schema named pff and create the following tables

    • forms to store form data
    • responses to store form response data
  5. Run your local dev server by running npm run dev

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Zaid Mukaddam – @zaidmukaddam

Project Link: https://github.com/zaidmukaddam/paperfreeform

GitHub

View Github