{"id":13552058,"url":"https://github.com/formio/formio-viewer","last_synced_at":"2025-06-28T21:44:53.472Z","repository":{"id":4969721,"uuid":"50586223","full_name":"formio/formio-viewer","owner":"formio","description":"Landing page viewer for forms and wizards within Form.io","archived":false,"fork":false,"pushed_at":"2025-06-11T16:09:38.000Z","size":220682,"stargazers_count":34,"open_issues_count":4,"forks_count":46,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-06-11T17:53:20.439Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://formview.io/#/examples/example","language":"HTML","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/formio.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","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,"zenodo":null}},"created_at":"2016-01-28T13:53:40.000Z","updated_at":"2025-05-27T15:09:48.000Z","dependencies_parsed_at":"2023-01-14T11:30:58.390Z","dependency_job_id":"f933f5ac-8066-466d-bcdd-122c407cbba8","html_url":"https://github.com/formio/formio-viewer","commit_stats":{"total_commits":408,"total_committers":22,"mean_commits":"18.545454545454547","dds":"0.23529411764705888","last_synced_commit":"1c35632d677cde7e3597ee194664ae8011f90540"},"previous_names":[],"tags_count":318,"template":false,"template_full_name":null,"purl":"pkg:github/formio/formio-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/formio","download_url":"https://codeload.github.com/formio/formio-viewer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formio%2Fformio-viewer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259316143,"owners_count":22839512,"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":[],"created_at":"2024-08-01T12:01:58.360Z","updated_at":"2025-06-28T21:44:53.456Z","avatar_url":"https://github.com/formio.png","language":"HTML","funding_links":[],"categories":["HTML","others"],"sub_categories":[],"readme":"# formio-viewer\n\n\u003e A lightweight [Form.io](https://github.com/formio/formio) application that renders form submissions as HTML before being converted to PDF.\n\nThis simple [Form.io](https://github.com/formio/formio) application is used by the [PDF Server](https://help.form.io/deployments/pdf-server) to generate PDFs from form submissions. Using this library, you can customize the submission PDFs that are generated by the PDF server.\n\n## Getting Started\n\nBecuase formio-viewer is mounted by the [Form.io PDF Server](https://help.form.io/deployments/pdf-server), this library is not available via a package manager such as NPM or yarn. To use it, clone the repository.\n\n```bash\n# if using SSH\ngit clone git@github.com:formio/formio-viewer\n\n# if using HTTPS\ngit clone https://github.com/formio/formio-viewer\n```\n\nYou can now install dependencies as normal.\n\n```bash\n# if using npm\nnpm install\n\n# if using yarn\nyarn\n```\n\nOnce you've made the desired modifications to the viewer, build the application.\n\n```bash\n# if using npm\nnpm run build\n\n# if using yarn\nyarn build\n```\n\nYou can now mount the dist folder at the endpoint of your choice and point the PDF Server to it for generating PDF submissions either by adding the URL of your custom viewer to the Form Settings (on a form-by-form basis) or by setting the PDF Server's FORMIO_VIEWER environment variable to the URL of your custom viewer.\n\nPLEASE NOTE that any modification of this library beyond adding basic HTML/CSS and/or custom assets is an advanced use case and is not recommended for users just starting out with the Form.io platform.\n\n## Example Usage\n\nIn this example, we'll add the Form.io logo to all of our PDF submissions.\n\nFirst, we'll update `index.html` to include the logo. Since formio-viewer currently uses Bootstrap 4.x by default, we'll use Bootstrap's built in [layout utilities](https://getbootstrap.com/docs/4.0/utilities/flex/#enable-flex-behaviors) and [navbar class](https://getbootstrap.com/docs/4.0/components/navbar/#brand). Note that the logo is being served from the `assets` directory.\n\n```html\n\u003c!-- index.html --\u003e\n\u003c!-- ... --\u003e\n\u003cbody\u003e\n  \u003cdiv class=\"container-fluid main pf\" id=\"main\"\u003e\n    \u003cnav class=\"navbar navbar-light bg-light\"\u003e\n      \u003cdiv class=\"d-flex\"\u003e\u003ch6\u003eOur Custom \u003c/h3\u003e\n        \u003cimg src=\"assets/logo.png\" width=\"100\" alt=\"The Form.io Logo\" /\u003e\n        \u003ch6\u003e Viewer!\u003c/h6\u003e\n      \u003c/div\u003e\n    \u003c/nav\u003e\n  \u003c!-- ... --\u003e\n  \u003c/div\u003e\n\u003c/body\u003e\n\u003c!-- ... --\u003e\n```\n\nAfter building our new viewer, we'll mount a simple HTTP server in the `dist` directory to check our work.\n\n```bash\nyarn build \u0026\u0026 cd dist \u0026\u0026 python -m http.server\n```\n\nLoad a form into the text input (e.g. https://examples.form.io/example) and click \"Show Form.\" You should see our new navbar component! Now each PDF submission generated using your custom viewer will contain this component.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformio%2Fformio-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fformio%2Fformio-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformio%2Fformio-viewer/lists"}