{"id":19816320,"url":"https://github.com/vocdoni/ui-components","last_synced_at":"2025-05-01T10:32:44.833Z","repository":{"id":96636346,"uuid":"575571264","full_name":"vocdoni/ui-components","owner":"vocdoni","description":"Vocdoni UI components libs","archived":false,"fork":false,"pushed_at":"2024-10-29T11:19:01.000Z","size":11499,"stargazers_count":3,"open_issues_count":28,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-29T12:11:31.081Z","etag":null,"topics":["blockchain-voting","react","react-components","vocdoni","vote"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vocdoni.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}},"created_at":"2022-12-07T20:15:29.000Z","updated_at":"2024-09-09T09:50:18.000Z","dependencies_parsed_at":"2023-09-23T01:54:46.747Z","dependency_job_id":"833d34b3-6cbb-4e82-be11-1e04c8220c65","html_url":"https://github.com/vocdoni/ui-components","commit_stats":null,"previous_names":[],"tags_count":135,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vocdoni%2Fui-components","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vocdoni%2Fui-components/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vocdoni%2Fui-components/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vocdoni%2Fui-components/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vocdoni","download_url":"https://codeload.github.com/vocdoni/ui-components/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223870798,"owners_count":17217452,"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":["blockchain-voting","react","react-components","vocdoni","vote"],"created_at":"2024-11-12T10:09:10.853Z","updated_at":"2024-11-12T10:09:11.689Z","avatar_url":"https://github.com/vocdoni.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://developer.vocdoni.io/img/vocdoni_logotype_full_blank.svg\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://developer.vocdoni.io/img/vocdoni_logotype_full_white.svg\" /\u003e\n      \u003cimg alt=\"Star History Chart\" src=\"https://developer.vocdoni.io/img/vocdoni_logotype_full_white.svg\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003ca href=\"https://github.com/vocdoni/ui-components/commits/main/\"\u003e\u003cimg src=\"https://img.shields.io/github/commit-activity/m/vocdoni/ui-components\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/vocdoni/ui-components/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/vocdoni/ui-components\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/vocdoni/ui-components/actions/workflows/test.yml/\"\u003e\u003cimg src=\"https://github.com/vocdoni/ui-components/actions/workflows/test.yml/badge.svg\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://discord.gg/xFTh8Np2ga\"\u003e\u003cimg src=\"https://img.shields.io/badge/discord-join%20chat-blue.svg\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/vocdoni\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/vocdoni.svg?style=social\u0026label=Follow\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n  \u003cdiv align=\"center\"\u003e\n    Vocdoni is the first universally verifiable, censorship-resistant, anonymous, and self-sovereign governance protocol. \u003cbr /\u003e\n    Our main aim is a trustless voting system where anyone can speak their voice and where everything is auditable. \u003cbr /\u003e\n    We are engineering building blocks for a permissionless, private and censorship resistant democracy.\n    \u003cbr /\u003e\n    \u003ca href=\"https://developer.vocdoni.io/\"\u003e\u003cstrong\u003eExplore the developer portal »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ch3\u003eMore About Us\u003c/h3\u003e\n    \u003ca href=\"https://vocdoni.io\"\u003eVocdoni Website\u003c/a\u003e\n    |\n    \u003ca href=\"https://vocdoni.app\"\u003eWeb Application\u003c/a\u003e\n    |\n    \u003ca href=\"https://explorer.vote/\"\u003eBlockchain Explorer\u003c/a\u003e\n    |\n    \u003ca href=\"https://law.mit.edu/pub/remotevotingintheageofcryptography/release/1\"\u003eMIT Law Publication\u003c/a\u003e\n    |\n    \u003ca href=\"https://chat.vocdoni.io\"\u003eContact Us\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ch3\u003eKey Repositories\u003c/h3\u003e\n    \u003ca href=\"https://github.com/vocdoni/vocdoni-node\"\u003eVocdoni Node\u003c/a\u003e\n    |\n    \u003ca href=\"https://github.com/vocdoni/vocdoni-sdk/\"\u003eVocdoni SDK\u003c/a\u003e\n    |\n    \u003ca href=\"https://github.com/vocdoni/ui-components\"\u003eUI Components\u003c/a\u003e\n    |\n    \u003ca href=\"https://github.com/vocdoni/ui-scaffold\"\u003eApplication UI\u003c/a\u003e\n    |\n    \u003ca href=\"https://github.com/vocdoni/census3\"\u003eCensus3\u003c/a\u003e\n  \u003c/div\u003e\n\n# ui-components\n\nThis repository aims to ease the creation of voting interfaces for user-facing applications. The purpose is to allow developers to easily integrate a variety of voting flow components and style these components as desired.\n\n## Included Packages\n\n| Component | Description |\n| ---: | --- |\n| [![chakra-components badge]][`@vocdoni/chakra-components`] | Voting-related react components built with chakra for easy integration with Vocdoni. |\n| [![rainbowkit-wallets badge]][`@vocdoni/rainbowkit-wallets`] | A set of custom wallets for rainbowkit. |\n| [![react-providers badge]][`@vocdoni/react-providers`] | React providers and hooks, where most of the Vocdoni protocol integration happens (required by `@vocdoni/chakra-components`) |\n| [![extended-sdk badge]][`@vocdoni/extended-sdk`] | Package extending our SDK functionalities (for advanced usage). |\n\nThe best place to learn about using ui-components packages is the [developer portal](https://developer.vocdoni.io/ui-components).\n\n### Table of Contents\n- [Getting Started](#getting-started)\n- [Reference](#reference)\n- [Examples](#examples)\n- [Preview](#preview)\n- [Disclaimer](#disclaimer)\n- [Contributing](#contributing)\n- [License](#license)\n\n\n## Getting Started\n\nEach of these packages can be used in a typescript/javascript project by importing them, eg. `yarn add @vocdoni/chakra-components`. Follow the developer documentation, or go to each individual package's readme file, for further details.\n\nEach of the packages has a typescript file configured as an entrypoint, so you should be able to just run `yarn dev` on the included chakra template to start developing any of the included packages.\n\nIf you link (via npm/yarn link) any of the included packages to your project, your project MUST be able to run typescript code. Otherwise it will fail.\n\nTurbo was initially configured for the development process, but its usage is minimal; still, you can use it for some global commands:\n\n- `yarn build`: will build every package in the monorepo (including templates)\n- `yarn clean`: removes `dist`, `.turbo` and `node_modules` folders in the\n  entire monorepo.\n- `yarn lint`: runs the linter of each package (may vary per package, but\n  usually prettier \u0026 tsc).\n- `yarn test`: runs all the tests in the monorepo. Note these are configured globally in the monorepo (testing dependencies are in the base `package.json` file)\n\n## Reference\n\nThe developer portal includes a [reference](https://developer.vocdoni.io/ui-components) for the `@vocdoni/chakra-components` package that also incorporates the full functionality of `@vocdoni/react-providers`.\n\n## Examples\n\nYou can find mock-functional examples of each of the chakra components in the ui-components [documentation](https://developer.vocdoni.io/ui-components/Election). There is also real-world usage of many of the components and providers from this library in the [code](https://github.com/vocdoni/ui-scaffold) for the Vocdoni application front-end.\n\n## Preview\n\nIn addition to the live examples in the documentation, you can see many of the components in use at https://app.vocdoni.io/\n\n## Disclaimer\n\nThis project is a WIP and is subject to continuous changes during its\ndevelopment. We encourage you to review this repository and the developer portal for any changes.\n\n## Contributing\n\nWhile we welcome contributions from the community, we do not track all of our issues on Github and we may not have the resources to onboard developers and review complex pull requests. That being said, there are multiple ways you can get involved with the project.\n\nPlease review our [development guidelines](https://developer.vocdoni.io/development-guidelines).\n\n## License\n\nThis repository is licensed under the [GNU Affero General Public License v3.0.](./LICENSE)\n\n    Vocdoni UI React Components\n    Copyright (C) 2024 Vocdoni Association\n\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU Affero General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU Affero General Public License for more details.\n\n    You should have received a copy of the GNU Affero General Public License\n    along with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n\n[`@vocdoni/chakra-components`]: ./packages/chakra-components/README.md\n[`@vocdoni/rainbowkit-wallets`]: ./packages/rainbowkit-wallets/README.md\n[`@vocdoni/react-providers`]: ./packages/react-providers/README.md\n[`@vocdoni/extended-sdk`]: ./packages/extended-sdk/README.md\n\n[chakra-components badge]: https://img.shields.io/npm/v/%40vocdoni%2Fchakra-components?label=%40vocdoni%2Fchakra-components\n[rainbowkit-wallets badge]: https://img.shields.io/npm/v/%40vocdoni%2Frainbowkit-wallets?label=%40vocdoni%2Frainbowkit-wallets\n[react-providers badge]: https://img.shields.io/npm/v/%40vocdoni%2Freact-providers?label=%40vocdoni%2Freact-providers\n[extended-sdk badge]: https://img.shields.io/npm/v/%40vocdoni%2Fextended-sdk?label=%40vocdoni%2Fextended-sdk\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvocdoni%2Fui-components","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvocdoni%2Fui-components","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvocdoni%2Fui-components/lists"}