{"id":15024612,"url":"https://github.com/formbee/formbee","last_synced_at":"2025-04-10T06:34:29.515Z","repository":{"id":248736682,"uuid":"829191369","full_name":"FormBee/FormBee","owner":"FormBee","description":"The open-source form backend for data privacy conscious developers.","archived":false,"fork":false,"pushed_at":"2025-01-29T05:17:41.000Z","size":13255,"stargazers_count":710,"open_issues_count":0,"forks_count":26,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-03T04:12:19.715Z","etag":null,"topics":["angularjs","docker","express","form","forms","formsubmission","nodejs","oauth2","open-source","railway"],"latest_commit_sha":null,"homepage":"https://formbee.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FormBee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-16T00:18:34.000Z","updated_at":"2025-04-03T01:36:18.000Z","dependencies_parsed_at":"2024-12-24T19:12:02.820Z","dependency_job_id":"5e5a5fd8-d341-4081-b523-fb6d43c99e5a","html_url":"https://github.com/FormBee/FormBee","commit_stats":{"total_commits":444,"total_committers":1,"mean_commits":444.0,"dds":0.0,"last_synced_commit":"6ae44eb944a0c9f2c53e6e75b0242b49424501fd"},"previous_names":["formbee/formbee"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FormBee%2FFormBee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FormBee%2FFormBee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FormBee%2FFormBee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FormBee%2FFormBee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FormBee","download_url":"https://codeload.github.com/FormBee/FormBee/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246933382,"owners_count":20857055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angularjs","docker","express","form","forms","formsubmission","nodejs","oauth2","open-source","railway"],"created_at":"2024-09-24T20:00:38.790Z","updated_at":"2025-04-03T04:12:28.378Z","avatar_url":"https://github.com/FormBee.png","language":"TypeScript","readme":"\n\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/FormBee/FormBee/blob/main/client/FormBee/src/assets/FormBee%20(1).png\" alt=\"FormBee\" width=\"200\" style=\"margin-left:200px;\"/\u003e\n\u003ch1\u003eForm Data Handling Made Easy.\u003c/h1\u003e\n\u003ch3\u003eThe open-source form backend for data privacy conscious developers.\u003c/h3\u003e\n\u003c/div\u003e\n\n---\n\n\u003ch2\u003e🐝 Overview\u003c/h2\u003e\n\n\u003cp\u003eFormBee is an easy way to send form data that is submitted on your website to your email, Telegram, Webhooks, Etc. It is a \"Form Backend\" which means it allows you to have functional forms that send places without having to write any server side code yourself! We have a hosted option available here: \u003ca href=\"https://formbee.dev\"\u003eFormBee Website\u003c/a\u003e or you can self-host it!\u003c/p\u003e\n\n---\n\n## Table of Contents\n- ✨ [Features](#-features)\n- 🏠 [Self Hosting](#-self-hosting)\n- 🔧 [Installation/Run Locally](#-installationrun-locally)\n   - 👨‍💻 [Client Side](#-client-side)\n   - 🖥 [Server Side](#-server-side)\n- 🌱 [Contributing](#-contributing)\n- 🛠 [Tech Stack](#-tech-stack)\n- 🏆 [Credits](#-credits)\n- 📜 [License](#-license)\n\n---\n\n\u003ch2\u003e✨ Features\u003c/h2\u003e\n\n\u003cul\u003e\n  \u003cli\u003e🌍 \u003cb\u003eOpen Source\u003c/b\u003e: Free to use, modify, and contribute.\u003c/li\u003e\n  \u003cli\u003e🔌 \u003cb\u003ePlugins\u003c/b\u003e: Easily send your form data to email, \u003ca\u003eMake.com\u003c/a\u003e, \u003ca\u003eTelegram\u003c/a\u003e, \u003ca\u003en8n\u003c/a\u003e, \u003ca\u003eDiscord\u003c/a\u003e, or \u003ca\u003eWebhooks\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e🔒 \u003cb\u003eCaptcha\u003c/b\u003e: Protect your forms from spam with our (PoW) Proof Of Work captchas.\u003c/li\u003e\n  \u003cli\u003e🔑 \u003cb\u003eWhite List Domains\u003c/b\u003e: Prevent others from using your form backend by whitelisting domains.\u003c/li\u003e\n  \u003cli\u003e↩️ \u003cb\u003eAutomatic return emails \u003c/b\u003e: Automatically send return emails to people who submit your forms.\u003c/li\u003e\n  \u003cli\u003e➕ \u003cb\u003eMore Features \u003c/b\u003e: FormBee has more to offer than we can fit in here! This is a work in progress passion project!\u003c/li\u003e\n\u003c/ul\u003e\n\n---\n\n\u003ch2\u003e🏠 Self Hosting\u003c/h2\u003e\n\u003cp\u003eWe want to make it as easy as possible to self host! In the \u003ccode\u003edocker-images\u003c/code\u003e folder of the project you will find many variations of the backend you can host, so you can host just what you want, without the bloat of the things you don't want. This is a work in progress, and we're constantly working on adding more. You can read more about self hosting in the \u003ca href=\"https://docs.formbee.dev/docs/category/self-hosting\"\u003eOfficial Formbee self-hosting docs\u003c/a\u003e. The docs will walk you through pulling the docker images, and running them with the correct environmental variables, then you can host them wherever you like to host your containers!\u003c/p\u003e\n\n\u003ch3\u003e🚆 Railway\u003c/h3\u003e\n\u003cp\u003eFormbee has official templates on Railway to make self hosting different Formbee backends as simple as clicking deploy and typing in a few environmental variables.\u003c/p\u003e\n\u003cul\u003e\n  \u003cli\u003e📧 \u003cb\u003e\u003ca href=\"https://railway.app/template/NR9kSH\"\u003eEmail Only Template\u003c/a\u003e\u003c/b\u003e: Host just a backend for recieving form data to your email.\u003c/li\u003e\n\u003c/ul\u003e\n\n---\n\n\u003ch2\u003e🔧 Installation/Run Locally\u003c/h2\u003e\n\nClone the repo: \n```bash\ngit clone https://github.com/FormBee/FormBee.git\n```\n\nFormBee is a monorepo, here are instructions for both the frontend and the backend.\n\n## 👨‍💻 Client Side\n\nEnter client directory: \n```bash\ncd FormBee\\client\\FormBee\n```\n\nInstall dependencies: \n```bash\nnpm install\n```\n\nMake your way to ```src/app/global-vars.ts``` and change fetchUrl to ```http://localhost:3000```\n\nRun client side: \n``` bash\nng serve\n```\n\n**With that, the client side should be running, go to [localhost:4200](http://localhost:4200).**\n## 🖥 Server Side\n\nEnter server directory: \n```bash\ncd FormBee/server/formbee\n```\n\nInstall Dependencies: \n```bash\nnpm install\n```\n\nCopy .env.example: \n```bash\ncp .env.example .env\n```\n\nConfigure your .env with your test database credentials (modify the ```DEV_DB``` env variables.)\nThe EMAIL env variables you see are for configuring the email which sends submission emails.\n\nMake your way to ```src/data-source.ts``` and comment out the second AppDataSource (Prod env vars), and uncomment the first AppDataSource (Dev env vars).\nLastly, make your way to ```src/index.ts``` and change the redirectUrl variable to ```http://localhost:4200```, this is for CORS.\n\nFinally \n```bash\nnpm run dev\n```\n\n**With that the server should be running.**\n\n---\n\n\n\n\u003ch2\u003e🌱 Contributing\u003c/h2\u003e \u003cp\u003eWe welcome contributions! Feel free to open an issue or submit a pull request if you'd like to help improve FormBee.\u003c/p\u003e \u003cul\u003e \u003cli\u003eFork the repository\u003c/li\u003e \u003cli\u003eCreate a new branch (\u003ccode\u003egit checkout -b feature-branch\u003c/code\u003e)\u003c/li\u003e \u003cli\u003eMake your changes\u003c/li\u003e \u003cli\u003eCommit your changes (\u003ccode\u003egit commit -m 'Add some feature'\u003c/code\u003e)\u003c/li\u003e \u003cli\u003ePush to the branch (\u003ccode\u003egit push origin feature-branch\u003c/code\u003e)\u003c/li\u003e \u003cli\u003eOpen a pull request\u003c/li\u003e \u003c/ul\u003e\n\n---\n\n\u003ch2\u003e🏆 Credits\u003c/h2\u003e \n\n\n\n\u003cp\u003e👋 Hey! I'm \u003ca href=\"https://github.com/Oia20\"\u003eJacob Dement\u003c/a\u003e, I created and currently maintain Formbee. \n\u003ca href=\"https://buymeacoffee.com/jacobdemenl\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\n\n(When you contribute feel free to sign and plug yourself here in your PR)\n\n---\n\n\u003ch2\u003e🛠 Tech Stack\u003c/h2\u003e\n\u003ctable\u003e \n  \u003ctr\u003e \n    \u003ctd\u003e\n      \u003cb\u003eFrontend\u003c/b\u003e\n    \u003c/td\u003e \n    \u003ctd\u003eAngular\u003c/td\u003e \n  \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cb\u003eBackend\u003c/b\u003e\u003c/td\u003e \n    \u003ctd\u003eNode.js/Express\u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \n      \u003ctd\u003e\u003cb\u003eDatabase\u003c/b\u003e\u003c/td\u003e \n      \u003ctd\u003ePostgres/TypeORM\u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \n        \u003ctd\u003e\u003cb\u003eStyling\u003c/b\u003e\u003c/td\u003e \n        \u003ctd\u003eSCSS/CSS\u003c/td\u003e \u003c/tr\u003e \n\u003c/table\u003e\n\n---\n\n\n\n\u003ch2\u003e📜 License\u003c/h2\u003e \u003cp\u003eThis project is licensed under the MIT License.\u003c/p\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e \u003ca href=\"https://github.com/Formbee/Formbee/issues\"\u003e \u003cimg alt=\"Issues\" src=\"https://img.shields.io/github/issues/Formbee/Formbee?color=brightgreen\"/\u003e \u003c/a\u003e \u003ca href=\"https://github.com/Formbee/Formbee\"\u003e \u003cimg alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/Formbee/Formbee?style=social\"/\u003e \u003c/a\u003e \u003c/div\u003e\n\u003cp align=\"center\"\u003e\u003ci\u003eGive it a go and recieve your form submissions easier than you ever have before.\u003c/i\u003e\u003c/p\u003e\n","funding_links":["https://buymeacoffee.com/jacobdemenl"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformbee%2Fformbee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fformbee%2Fformbee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformbee%2Fformbee/lists"}