{"id":13516066,"url":"https://github.com/formio/formio","last_synced_at":"2025-05-12T15:33:27.563Z","repository":{"id":37431985,"uuid":"44027524","full_name":"formio/formio","owner":"formio","description":"A Form and Data Management Platform for Progressive Web Applications.","archived":false,"fork":false,"pushed_at":"2025-05-12T14:04:33.000Z","size":21234,"stargazers_count":2171,"open_issues_count":61,"forks_count":747,"subscribers_count":91,"default_branch":"master","last_synced_at":"2025-05-12T15:24:36.690Z","etag":null,"topics":["angular","angularjs","forms","nodejs","react","serverless","vanilla-js","vanillajs","vue"],"latest_commit_sha":null,"homepage":"https://form.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"osl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/formio.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-10-10T20:41:03.000Z","updated_at":"2025-05-09T00:31:21.000Z","dependencies_parsed_at":"2023-09-22T18:46:41.926Z","dependency_job_id":"48d23d17-8cb9-478d-9073-6b9d5fd78d6b","html_url":"https://github.com/formio/formio","commit_stats":{"total_commits":2731,"total_committers":96,"mean_commits":"28.447916666666668","dds":0.639692420358843,"last_synced_commit":"509c293a37e641027a64a922e9a55f0731a46ae3"},"previous_names":[],"tags_count":1101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/formio","download_url":"https://codeload.github.com/formio/formio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253766157,"owners_count":21960856,"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":["angular","angularjs","forms","nodejs","react","serverless","vanilla-js","vanillajs","vue"],"created_at":"2024-08-01T05:01:18.759Z","updated_at":"2025-05-12T15:33:27.550Z","avatar_url":"https://github.com/formio.png","language":"JavaScript","readme":"[![Join the chat at https://gitter.im/formio/formio](https://badges.gitter.im/formio/formio.svg)](https://gitter.im/formio/formio?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nForm.io Community Edition\n================================\nForm.io is a revolutionary combined Form and API platform for progressive applications. This repository serves as the core Form and API engine for https://form.io. This system allows you to build data-driven, form-based applications using a simple drag-and-drop form builder interface. These forms can then easily be embedded within your Angular.js and React applications using the\n```\u003cformio\u003e``` HTML element.\n\nForm Building \u0026 Rendering Demo\n-------------------\nHere is a link to a demo of the Form Building and Form Rendering capability that can be hooked into this API platform.\n\n[https://formio.github.io/formio.js/app/builder.html](https://formio.github.io/formio.js/app/builder.html)\n\nRun with Docker Compose\n------------------\nThe fastest way to run this library locally is to use [Docker](https://docker.com).\n\n - [Install Docker](https://docs.docker.com/engine/install/)\n - Download and unzip this package to a local directory on your machine.\n - Open up your terminal and navigate to the unzipped folder of this library.\n - Type the following in your terminal\n    ```\n    docker compose up -d\n    ```\n - Go to the following URL in your browser.\n    ```\n    http://localhost:3001\n    ```\n - Use the following credentials to login.\n    - **email**: admin@example.com\n    - **password**: CHANGEME\n - To change the admin password.\n    - Once you login, click on the **Admin** resource\n    - Click **View Data**\n    - Click on the **admin@example.com** row\n    - Click **Edit Submission**\n    - Set the password field\n    - Click **Save Submission**\n    - Logout\n\n - Have fun!\n\nManual Installation (Node + MongoDB)\n-------------------\nTo get started you will first need the following installed on your machine.\n\n  - Node.js - https://nodejs.org/en/\n  - MongoDB - http://docs.mongodb.org/manual/installation/\n    - On Mac I recommend using Homebrew `brew install mongodb-community`\n    - On Windows, download and install the MSI package @ https://www.mongodb.org/downloads\n  - You must then make sure you have MongoDB running by typing `mongod` in your terminal.\n\nRunning with Node.js\n-------------------\nYou can then download this repository, navigate to the folder in your Terminal, and then type the following.\n\n```bash\n# install dependencies\nyarn\n# build the client application\nyarn build:portal\n# start the server\nyarn start\n```\n\nThis will walk you through the installation process.  When it is done, you will have a running Form.io management\napplication running at the following address in your browser.\n\n```\nhttp://localhost:3001\n```\n\nDevelopment\n--------------------\nTo start server with auto restart capability for development simply run this command:\n```\nnpm run start:dev\n```\n\nDeploy to Hosted Form.io\n--------------------\nIf you wish to deploy all of your forms and resources into the Form.io Hosted platform @ https://portal.form.io or Form.io Self-Hosted platform, you can do this by using the Form.io CLI command line tool.\n\n```\nnpm install -g formio-cli\n```\n\nOnce you have this tool installed, you will need to follow these steps.\n - Create a new project within Form.io\n - Create an API Key within this project by going to the **Project Settings | Stage Settings | API Keys**\n - Next, you can execute the following command to deploy your local project into Hosted Form.io.\n\n```\nformio deploy http://localhost:3001 https://{PROJECTNAME}.form.io --src-key {srcAPIKEY} --dst-key {dstAPIKEY}\n```\n\nYou will need to make sure you replace ```{PROJECTNAME}``` and ```{APIKEY}``` with your new Hosted Form.io project name (found in the API url), as well as the API key that was created in the second step above.\n\nAdding API Keys to your server\n--------------------\nAPI Keys are used for server to server communication. To add API Key(s) to your server you will need to put the property \nAPI_KEYS in your environment variables when running the server with node. You can do this by running your server using the following command  \n``API_KEYS=\u003cyourapikey(s)\u003e node --no-node-snapshot main.js``\n\nLicense Change (March 8th, 2020)\n--------------------\nThis library is now licensed under the OSL-v3 license, which is a copy-left OSI approved license. Please read the license @ https://opensource.org/licenses/OSL-3.0 for more information. Our goal for the change to OSLv3 from BSD is to ensure that appropriate Attribution is provided when creating proprietary products that leverage or extend this library.\n\nHelp\n--------------------\nWe will be updating the help guides found @ https://help.form.io as questions arise and also to help you get started with Form.io.\n\nThanks for using Form.io!\n\nThe Form.io Team.\n\nSecurity\n=========\nIf you find and/or think you have found a Security issue, please quietly disclose it to security@form.io, and give us\nsufficient time to patch the issue before disclosing it publicly.\n\ntest change 5","funding_links":[],"categories":["HTML","JavaScript","Open Source Form Builders","Application Recommendation","angular","Digital Health Infrastructure"],"sub_categories":["🤝 Collaborative Office","Patient Portals \u0026 Intake"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformio%2Fformio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fformio%2Fformio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformio%2Fformio/lists"}