{"id":21593286,"url":"https://github.com/peterkottas/guestbell-forms","last_synced_at":"2025-08-22T02:06:36.845Z","repository":{"id":52572344,"uuid":"99428818","full_name":"PeterKottas/guestbell-forms","owner":"PeterKottas","description":"Beautiful react forms with built-in validation ","archived":false,"fork":false,"pushed_at":"2025-08-21T13:17:18.000Z","size":29485,"stargazers_count":16,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-21T13:52:47.817Z","etag":null,"topics":["form-validation","forms","input-validation","lightweight","material-design","material-ui","react"],"latest_commit_sha":null,"homepage":null,"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/PeterKottas.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,"zenodo":null}},"created_at":"2017-08-05T14:48:28.000Z","updated_at":"2025-08-21T13:17:21.000Z","dependencies_parsed_at":"2024-06-19T05:17:07.569Z","dependency_job_id":"4b83951e-4a02-4d02-b552-d28716c1b107","html_url":"https://github.com/PeterKottas/guestbell-forms","commit_stats":{"total_commits":1332,"total_committers":1,"mean_commits":1332.0,"dds":0.0,"last_synced_commit":"a117f761b12634d5111872bbab0880fe01801aa8"},"previous_names":[],"tags_count":657,"template":false,"template_full_name":null,"purl":"pkg:github/PeterKottas/guestbell-forms","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterKottas%2Fguestbell-forms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterKottas%2Fguestbell-forms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterKottas%2Fguestbell-forms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterKottas%2Fguestbell-forms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PeterKottas","download_url":"https://codeload.github.com/PeterKottas/guestbell-forms/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterKottas%2Fguestbell-forms/sbom","scorecard":{"id":109384,"data":{"date":"2025-08-11","repo":{"name":"github.com/PeterKottas/guestbell-forms","commit":"f6a3a578cd298427d9168d084351d6d24834f936"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}}]},"last_synced_at":"2025-08-15T11:45:12.142Z","repository_id":52572344,"created_at":"2025-08-15T11:45:12.143Z","updated_at":"2025-08-15T11:45:12.143Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271574431,"owners_count":24783319,"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","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["form-validation","forms","input-validation","lightweight","material-design","material-ui","react"],"created_at":"2024-11-24T17:11:58.479Z","updated_at":"2025-08-22T02:06:36.799Z","avatar_url":"https://github.com/PeterKottas.png","language":"TypeScript","readme":"# GuestBell forms\n\nBeautiful, lightweight react forms and form elements. Includes zero setup validation. Entirely written in typescript therefore typings are always valid and up to date.\n\n## Demo\n\nCheck out [demo](https://peterkottas.github.io/guestbell-forms)\n\nor\n\nClone this repo and\n\n```\nnpm install\nnpm start\n```\n\n## Important note\n\nThis library is actively used in our startup called GuestBell. This is therefore production code which will be maintained an improved on regular basis. All help is much appreciated!\nThe reason why we created is most simmilar libraries out there utilize either jQuery or some other huge libraries. This is a litweight solution which will guarantee your website speed and small size.\n\n## Installation\n\nUsing npm:\n\n```\nnpm install guestbell-forms --save\n```\n\n## Quick start\n\nJust import your components like this\n\n```\nimport { Form, Text, Select, Submit, DynamicSubmit, IBaseValidator, Checkbox, Radio, RadioContainer } from 'guestbell-forms';\n```\n\nAnd use them in your react elements.\n\n## Usage\n\nCheck out this simple example:\n\n```\n\u003cForm className=\"container\"\u003e\n\t\u003cdiv className=\"row\"\u003e\n\t\t\u003cdiv className=\"col-lg-6\"\u003e\n\t\t\t\u003cText\n\t\t\t\trequired={true}\n\t\t\t\tlabel=\"Username\"\n\t\t\t\tvalue={this.state.name}\n\t\t\t\tonChange={this.handleNameChange} /\u003e\n\t\t\u003c/div\u003e\n\t\t\u003cdiv className=\"col-lg-6\"\u003e\n\t\t\t\u003cSelect\n\t\t\t\trequired={true}\n\t\t\t\tlabel={'Gender'}\n\t\t\t\tvalues={[{ value: 'M', label: 'Male' }, { value: 'F', label: 'Female' }]}\n\t\t\t\tonChange={this.handleGenderChange}\n\t\t\t\tvalue={this.state.gender} /\u003e\n\t\t\u003c/div\u003e\n\t\u003c/div\u003e\n\t\u003cdiv className=\"row\"\u003e\n\t\t\u003cdiv className=\"col-lg-6\"\u003e\n\t\t\t\u003cTextInput\n\t\t\t\tvalidators={[\"email\"]}\n\t\t\t\trequired={true}\n\t\t\t\tlabel=\"Email\"\n\t\t\t\tvalue={this.state.email}\n\t\t\t\tonChange={this.handleEmailChange} /\u003e\n\t\t\u003c/div\u003e\n\t\t\u003cdiv className=\"col-lg-6\"\u003e\n\t\t\t\u003cText\n\t\t\t\tcustomValidators={[AgeValidator.instance]}\n\t\t\t\tlabel=\"Age (optional)\"\n\t\t\t\tvalue={this.state.age}\n\t\t\t\tonChange={this.handleAgeChange} /\u003e\n\t\t\u003c/div\u003e\n\t\u003c/div\u003e\n\t\u003cdiv className=\"row justify-content-center align-items-center\"\u003e\n\t\t\u003cSubmit\n\t\t\tclassName=\"btn btn-primary btn-lg\"\n\t\t\tonClick={this.submitForm}\u003e\n\t\t\t\tSubmit\n\t\t\u003c/Submit\u003e\n\t\u003c/div\u003e\n\u003c/Form\u003e\n```\n\n1. Notice there's no passing props around, yet the form validates perfectly and the submit button is enabled/disabled through magic or react :)\n2. See how we support built-in validators (validators={[\"email\"]}) and even custom validators (customValidators={[AgeValidator.instance]})\n3. Custom validators are easy to work with, take a look at this AgeValidator\n\n```\nclass AgeValidator implements IBaseValidator {\n\tpublic static instance = new AgeValidator();\n\tpublic Validate(value: string, isRequired: boolean, addError: (error: string) =\u003e void): boolean {\n\t\tlet number = Number(value);\n\t\tif (!isNaN(number)) {\n\t\t\tif (number \u003c 0) {\n\t\t\t\taddError('Not born yet?');\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (number \u003e 122) {\n\t\t\t\taddError('Older than Jeanne Calment? C\\'mon');\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\t\telse {\n\t\t\taddError('Invalid age');\n\t\t}\n\t\treturn false;\n\t}\n}\n```\n\nJust a class with one method. We provide the static instance for simplicity.\n\n4. All inputs work like typical react inputs. It's recommended to bind them with the value and the change handler.\n\n## Created and sponsored by\n\n- [GuestBell](https://guestbell.com/) - Customer centric online POS for Hotels and short terms stays.\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request :D\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterkottas%2Fguestbell-forms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterkottas%2Fguestbell-forms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterkottas%2Fguestbell-forms/lists"}