{"id":13515646,"url":"https://github.com/amazingandyyy/use-form-react","last_synced_at":"2025-04-30T17:13:31.739Z","repository":{"id":57388070,"uuid":"184202597","full_name":"amazingandyyy/use-form-react","owner":"amazingandyyy","description":"⚡ React form hook made blazing fast and easy.","archived":false,"fork":false,"pushed_at":"2022-04-19T14:42:51.000Z","size":25,"stargazers_count":34,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-30T17:13:21.047Z","etag":null,"topics":["form","form-hook","hook","react","react-hook"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/use-form-react","language":"JavaScript","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/amazingandyyy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-30T06:13:08.000Z","updated_at":"2023-12-20T07:46:32.000Z","dependencies_parsed_at":"2022-08-29T14:31:52.443Z","dependency_job_id":null,"html_url":"https://github.com/amazingandyyy/use-form-react","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fuse-form-react","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fuse-form-react/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fuse-form-react/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fuse-form-react/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amazingandyyy","download_url":"https://codeload.github.com/amazingandyyy/use-form-react/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251748956,"owners_count":21637418,"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":["form","form-hook","hook","react","react-hook"],"created_at":"2024-08-01T05:01:14.108Z","updated_at":"2025-04-30T17:13:31.712Z","avatar_url":"https://github.com/amazingandyyy.png","language":"JavaScript","readme":"\u003ch1 align=\"center\"\u003e\n⚡ useForm\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\nForm hook made blazing fast and easy.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://circleci.com/gh/amazingandyyy/use-form-react\"\u003e\n      \u003cimg src=\"https://circleci.com/gh/amazingandyyy/use-form-react.svg?style=svg\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/amazingandyyy/use-form-react/blob/master/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/amazingandyyy/use-form/pulls\"\u003e\n        \u003cimg src=\"https://camo.githubusercontent.com/d4e0f63e9613ee474a7dfdc23c240b9795712c96/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e737667\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e The most unopinionated form hook.\n\n## Installation\n\n```shell\nnpm i --save use-form-react\n# or\nyarn add use-form-react\n```\n\n## Have a good to use form in 10 seconds\n\n![demo](https://media.giphy.com/media/jkYpOoNMkZAk8y9u8F/giphy.gif)\n\n## Usage\n\n### Basic Usage\n\ncheck [basic example](https://github.com/amazingandyyy/use-form-react/blob/master/examples/basic/index.js)\n\n```jsx\nimport useForm from 'use-form-react'\n\nconst Form = () =\u003e {\n  const { onSubmit, onChange, inputs } = useForm('sampleForm', {\n      initialValues: { 'name': '' },\n      callback: (inputs) =\u003e console.log(inputs)\n    }\n  )\n  return (\n    \u003cdiv\u003e\n      \u003cdiv\u003eHello {inputs.name}\u003c/div\u003e\n      \u003cform onSubmit={onSubmit}\u003e\n        \u003cinput name=\"name\" value={inputs.name} onChange={onChange} /\u003e\n        \u003cbutton type=\"submit\"\u003eSign in\u003c/button\u003e\n      \u003c/form\u003e\n    \u003c/div\u003e\n  );\n}\n```\n\n### Advance Usage\n\ncheck [advance example](https://github.com/amazingandyyy/use-form-react/blob/master/examples/advance/index.js)\n\n```jsx\nimport React, { useEffect } from 'react';\nimport useForm from 'use-form-react'\n\nconst SignUp = () =\u003e {\n  const options = {\n    initialValues: {\n      email: '',\n      password1: '',\n      password2: ''\n    },\n    validation: {\n      email: (inputs) =\u003e {\n        const emailRegex = /^(([^\u003c\u003e()\\[\\]\\\\.,;:\\s@\"]+(\\.[^\u003c\u003e()\\[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$/\n        \n        if (!inputs.email || inputs.email === '') {\n          return 'email is required';\n        }\n\n        if (!emailRegex.test(inputs.email.toLowerCase())) {\n          return 'invalid email';\n        }\n      },\n      password1: (inputs) =\u003e {\n        const passwordRegex = /((?=.*\\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[\\W]).{6,20})/\n\n        if (!inputs.password1 || inputs.password1 === '') {\n          return 'password is required';\n        }\n\n        if (!passwordRegex.test(inputs.password1)) {\n          return 'password is too simple';\n        }\n      },\n      password2: (inputs) =\u003e {\n        if (!inputs.password2 || inputs.password2 === '') {\n          return 'password is required';\n        }\n\n        if (inputs.password1 !== inputs.password2) {\n          return 'password are differents';\n        }\n      }\n    },\n    callback: () =\u003e console.log('works!', inputs)\n  }\n\n  const { onSubmit, onChange, inputs, dirty, submitting, reset, errors, valid } = useForm('AdvanceForm', options)\n\n  return (\n    \u003cform onSubmit={onSubmit} noValidate\u003e\n      \u003cinput\n        type='email'\n        name=\"email\"\n        value={inputs.email}\n        placeholder=\"Email\"\n        onChange={onChange}\n        /\u003e\n      \u003cdiv\u003e{errors.email}\u003c/div\u003e\n      \u003cinput\n        type='password'\n        name=\"password1\"\n        value={inputs.password1}\n        placeholder=\"Password\"\n        onChange={onChange}\n        /\u003e\n      \u003cdiv\u003e{errors.password1}\u003c/div\u003e\n      \u003cinput\n        type='password'\n        name=\"password2\"\n        value={inputs.password2}\n        placeholder=\"Confirm password\"\n        onChange={onChange}\n        /\u003e\n        \u003cdiv\u003e{errors.password2}\u003c/div\u003e\n      \u003cbutton disabled={!dirty || !valid || submitting} type=\"submit\"\u003eSign up\u003c/button\u003e\n    \u003c/form\u003e\n  );\n}\n```\n\n## To Do\n\n- [ ] better test case\n- [ ] debounce the error\n- [x] built-in validation - done by [#3](https://github.com/amazingandyyy/use-form-react/pull/3)\n- [x] support ts - done by [#4](https://github.com/amazingandyyy/use-form-react/pull/4)\n- [ ] ts docs\n\n## License\n\nMIT\n\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famazingandyyy%2Fuse-form-react","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famazingandyyy%2Fuse-form-react","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famazingandyyy%2Fuse-form-react/lists"}