{"id":13989710,"url":"https://github.com/brainhubeu/react-permissible","last_synced_at":"2025-05-16T07:00:59.100Z","repository":{"id":40827473,"uuid":"111721023","full_name":"brainhubeu/react-permissible","owner":"brainhubeu","description":"👮‍♂️Making the permission management for React components easier.","archived":false,"fork":false,"pushed_at":"2025-05-09T04:19:35.000Z","size":4461,"stargazers_count":154,"open_issues_count":50,"forks_count":25,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-09T05:25:31.997Z","etag":null,"topics":["callback","javascript","mocha","optional-props","permission-manager","permissions","props","react","typescript","webpack"],"latest_commit_sha":null,"homepage":"https://brainhub.eu","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/brainhubeu.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-22T18:50:27.000Z","updated_at":"2024-11-02T11:24:16.000Z","dependencies_parsed_at":"2023-10-14T23:12:29.296Z","dependency_job_id":"5e8c710c-fc44-4da2-be94-8d8412788536","html_url":"https://github.com/brainhubeu/react-permissible","commit_stats":{"total_commits":221,"total_committers":14,"mean_commits":"15.785714285714286","dds":0.7601809954751131,"last_synced_commit":"f9122aa4c94555c84f71617980b7ccf709fbb618"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainhubeu%2Freact-permissible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainhubeu%2Freact-permissible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainhubeu%2Freact-permissible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainhubeu%2Freact-permissible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brainhubeu","download_url":"https://codeload.github.com/brainhubeu/react-permissible/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485025,"owners_count":22078764,"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":["callback","javascript","mocha","optional-props","permission-manager","permissions","props","react","typescript","webpack"],"created_at":"2024-08-09T13:01:59.273Z","updated_at":"2025-05-16T07:00:59.046Z","avatar_url":"https://github.com/brainhubeu.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cbr/\u003e\n\u003ch1 align=\"center\"\u003e\n  react-permissible\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Making the permission management for React components easier.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e\n    \u003ca href=\"https://brainhubeu.github.io/react-permissible/\"\u003eLive code demo\u003c/a\u003e | \n    \u003ca href=\"https://brainhub.eu/contact/\"\u003eHire us\u003c/a\u003e\n  \u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n  [![CircleCI](https://circleci.com/gh/brainhubeu/react-permissible.svg?style=svg)](https://circleci.com/gh/brainhubeu/react-permissible)\n  [![Last commit](https://img.shields.io/github/last-commit/brainhubeu/react-permissible.svg)](https://github.com/brainhubeu/react-permissible/commits/master)\n  [![license](https://img.shields.io/npm/l/@brainhubeu/react-permissible.svg)](https://github.com/brainhubeu/react-permissible/blob/master/LICENSE.md)\n  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n  [![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)\n\n  [![Coveralls github](https://img.shields.io/coveralls/github/brainhubeu/react-permissible.svg)](https://coveralls.io/github/brainhubeu/react-permissible?branch=master)\n  [![Downloads](https://img.shields.io/npm/dm/@brainhubeu/react-permissible?color=blue)](https://www.npmjs.com/package/@brainhubeu/react-permissible)\n  [![Minified](https://img.shields.io/bundlephobia/min/@brainhubeu/react-permissible?label=minified)](https://www.npmjs.com/package/@brainhubeu/react-permissible)\n  [![npm](https://img.shields.io/npm/v/@brainhubeu/react-permissible.svg)](https://www.npmjs.com/package/@brainhubeu/react-permissible)\n  [![Contributors](https://img.shields.io/github/contributors/brainhubeu/react-permissible?color=blue)](https://github.com/brainhubeu/react-permissible/graphs/contributors)\n\u003c/div\u003e\n\n\n`react-permissible` is a React Component allowing to:\n* manage visibility of particular components depending on users permissions\n* replace particular component when the user isn't permitted to see it\n* manage accessability to particular view depending on users permissions\n* fire a callback when the user isn't allowed to go to access the component/route\n\n## Why?\nCurrently there's no permission management in React. The existing components are either over-engineered (full ACL support etc.), or limited to role-based management. `react-permissible` is simple at its core and solves only one problem. Access the Component if the permissions match, do something otherwise.\n\n## Live demo/ docs\nYou can access live demo/ docs at https://brainhubeu.github.io/react-permissible/.\n\n## Installation\n```\nnpm i @brainhubeu/react-permissible\n```\n\n## Usage\n```javascript\nimport { PermissibleRender } from '@brainhubeu/react-permissible';\n\n...\n\nrender() {\n  return (\n    \u003cPermissibleRender\n      userPermissions={permissions}\n      requiredPermissions={requiredPermissions}\n    \u003e\n      \u003cRestrictedComponent/\u003e\n    \u003c/PermissibleRender\u003e\n  );\n}\n```\n\nWhere:\n* `userPermissions` is an **array** of permissions set for current user\n* `requiredPermissions` is an **array** of required permissions\n\nMore detailed documentation with several use cases covered is available [here](http://brainhubeu.github.io/react-permissible).\n\n## Running tests\n```\nnpm test\n```\n\n## Roadmap\n* Passing a callback function as a prop for `PermissibleRender` component\n\n## License\n\nReact-permissible is copyright © 2017-2020 [Brainhub](https://brainhub.eu/?utm_source=github) It is free software, and may be redistributed under the terms specified in the [license](LICENSE.md).\n\n## About\n\n`react-permissible` is maintained by [@kkoscielniak](https://github.com/kkoscielniak), [@adam-golab](https://github.com/adam-golab), [@Lukasz-pluszczewski](https://github.com/Lukasz-pluszczewski/) and the Brainhub development team. It is funded by Brainhub and the names and logos for Brainhub are trademarks of Brainhub Sp. z o.o.. You can check other open-source projects supported/developed by our teammates [here](https://brainhub.eu/?utm_source=github). \n\n[![Brainhub](https://brainhub.eu/brainhub.svg)](https://brainhub.eu/?utm_source=github)\n\nWe love open-source JavaScript software! See our other projects or hire us to build your next web, desktop and mobile application with JavaScript.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainhubeu%2Freact-permissible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrainhubeu%2Freact-permissible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainhubeu%2Freact-permissible/lists"}