{"id":15311525,"url":"https://github.com/dbismut/react-guify","last_synced_at":"2025-07-27T19:41:21.815Z","repository":{"id":44021263,"uuid":"230535202","full_name":"dbismut/react-guify","owner":"dbismut","description":"Thin wrapper around guify","archived":false,"fork":false,"pushed_at":"2023-01-05T03:47:19.000Z","size":1454,"stargazers_count":8,"open_issues_count":15,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-22T01:54:01.684Z","etag":null,"topics":["gui","guify","react"],"latest_commit_sha":null,"homepage":"https://github.com/colejd/guify","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/dbismut.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}},"created_at":"2019-12-28T00:03:32.000Z","updated_at":"2023-11-04T13:42:51.000Z","dependencies_parsed_at":"2023-02-03T09:30:23.317Z","dependency_job_id":null,"html_url":"https://github.com/dbismut/react-guify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dbismut/react-guify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbismut%2Freact-guify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbismut%2Freact-guify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbismut%2Freact-guify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbismut%2Freact-guify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbismut","download_url":"https://codeload.github.com/dbismut/react-guify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbismut%2Freact-guify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260663115,"owners_count":23044056,"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":["gui","guify","react"],"created_at":"2024-10-01T08:33:49.928Z","updated_at":"2025-06-19T01:33:56.348Z","avatar_url":"https://github.com/dbismut.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# react-guify\n\n![npm (tag)](https://img.shields.io/npm/v/react-guify) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/react-guify) ![NPM](https://img.shields.io/npm/l/react-guify)\n\nReact-guify is a thin wrapper around the [simple GUI library guify](https://github.com/colejd/guify).\n\n![image](https://raw.githubusercontent.com/colejd/guify/master/docs/Guify.png)\n\n[Demo](https://codesandbox.io/s/react-guify-154rk)\n\n### Installation\n\n```bash\n#Yarn\nyarn add guify react-guify\n\n#NPM\nnpm install guify react-guify\n```\n\n### Example\n\n```jsx\nfunction App() {\n  const [state, setState] = React.useState(initialState)\n  const gui = React.useRef()\n  return (\n    \u003cGuiPanel\n      ref={gui}\n      data={state}\n      setData={setState}\n      barMode=\"above\"\n      theme=\"light\"\n    \u003e\n      \u003cGuiButton\n        label=\"Toast\"\n        action={() =\u003e {\n          gui.current.Toast('Current date: ' + Date.now())\n        }}\n      /\u003e\n      \u003cGuiText property=\"name\" /\u003e\n      \u003cGuiTitle label=\"Options\" /\u003e\n      \u003cGuiFile label=\"Select File\" property=\"file\" /\u003e\n      \u003cGuiDisplay property=\"name\" /\u003e\n      \u003cGuiCheckbox property=\"checkeds\" /\u003e\n      \u003cGuiColor property=\"color\" /\u003e\n      \u003cGuiFolder label=\"Bounds Folder\" open={true}\u003e\n        \u003cGuiRange\n          label=\"bounds\"\n          property=\"bounds\"\n          scale=\"log\"\n          onChange={value =\u003e console.log({ value })}\n        /\u003e\n        \u003cGuiSelect property=\"movement\" options={options} /\u003e\n        \u003cGuiInterval property=\"interval\" min={5} max={70} /\u003e\n      \u003c/GuiFolder\u003e\n    \u003c/GuiPanel\u003e\n  )\n}\n```\n\n## Api\n\n### Components exports\n\nReact-guify creates and exports React components that allow you to structure the GUI with React nodes.\n\nYou can pass all options from guify as props to these components. For now components will not respond to props update.\n\n[Read guify docs for more](https://github.com/colejd/guify/).\n\n#### Main panel\n\n- `GuiPanel`: guify main panel.\n\nIn addition to the native options from guify, the panel requires two additional props:\n\n- `data`: the data object bound to components.\n- `setData`: the function the panel will call to update your data when values change.\n\n#### Data-bound components\n\n- `GuiCheckbox`: a checkbox\n- `GuiRange`: a number selector\n- `GuiInterval`: an interval selector\n- `GuiColor`: a color selector\n- `GuiSelect`: an option selector\n- `GuiText`: a free-text entry\n- `GuiDisplay`: displays a variable\n- `GuiFile`: a file selector\n\n#### Action components\n\n- `GuiButton`: a button with an action\n\n#### Organizational components:\n\n- `GuiTitle`: shows a title\n- `GuiFolder`: a folder grouping different components\n\n### Toast\n\nguify has a nice toast feature that React-guify tries to implement seamlessly. The panel component will pass back a ref to you, which will include the original `gui` object created by guify.\n\n```jsx\nfunction ToastExample() {\n  const [state, setState] = React.useState(initialState)\n  const gui = React.useRef()\n  return (\n    \u003cGuiPanel ref={gui} data={state} setData={setState}\u003e\n      \u003cGuiButton\n        label=\"Toast\"\n        action={() =\u003e gui.current.Toast('Hello from Toast')}\n      /\u003e\n    \u003c/GuiPanel\u003e\n  )\n}\n```\n\n---\n\n### Todo List\n\n- [ ] Proper mounting and unmounting\n- [ ] Updating props on the fly\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbismut%2Freact-guify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbismut%2Freact-guify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbismut%2Freact-guify/lists"}