{"id":22799917,"url":"https://github.com/tangle-network/dapp","last_synced_at":"2025-04-19T16:45:06.792Z","repository":{"id":37030850,"uuid":"331384753","full_name":"tangle-network/dapp","owner":"tangle-network","description":"Monorepo for the Tangle ecosystem.","archived":false,"fork":false,"pushed_at":"2025-04-13T12:58:23.000Z","size":275229,"stargazers_count":30,"open_issues_count":48,"forks_count":20,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2025-04-13T13:34:07.420Z","etag":null,"topics":["blockchain","cryptocurrency","dapp","frontend","monorepo"],"latest_commit_sha":null,"homepage":"https://app.tangle.tools","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tangle-network.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-01-20T17:45:42.000Z","updated_at":"2025-04-07T19:31:23.000Z","dependencies_parsed_at":"2023-09-21T19:09:00.704Z","dependency_job_id":"c7ddee47-7171-4465-a124-d0e307fd2280","html_url":"https://github.com/tangle-network/dapp","commit_stats":null,"previous_names":["tangle-network/dapp","webb-tools/webb-dapp"],"tags_count":85,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fdapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fdapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fdapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fdapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tangle-network","download_url":"https://codeload.github.com/tangle-network/dapp/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248724009,"owners_count":21151555,"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","cryptocurrency","dapp","frontend","monorepo"],"created_at":"2024-12-12T07:10:25.432Z","updated_at":"2025-04-19T16:45:06.784Z","avatar_url":"https://github.com/tangle-network.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.tangle.tools/\"\u003e\n\n![Tangle Logo](./.github/assets/tangle-banner.png)\n\u003c/a\u003e\n\n  \u003c/div\u003e\n\n# Tangle Monorepo\n\n\u003cp align=\"left\"\u003e\n    \u003cstrong\u003eDecentralized interfaces into the Tangle Network, featuring Tangle Network dApps for MPC-as-a-service restaking infrastructure.\u003c/strong\u003e\n    \u003cbr /\u003e\n\u003c/p\u003e\n\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/tangle-network/dapp/check-build.yml?branch=develop\u0026style=flat-square)](https://github.com/tangle-network/dapp/actions)\n[![License Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![Follow Tangle on twitter](https://img.shields.io/twitter/follow/tangle_network.svg?style=social)](https://twitter.com/intent/follow?screen_name=tangle_network)\n[![Telegram](https://img.shields.io/badge/Telegram-gray?logo=telegram)](https://t.me/tanglenet) [![Discord](https://img.shields.io/discord/833784453251596298.svg?style=flat-square\u0026label=Discord\u0026logo=discord)](https://discord.gg/cv8EfJu3Tn)\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003ch2 id=\"table-of-contents\" style=border:0!important\u003e Table of Contents \u003c/h2\u003e\n\n\u003cdetails open=\"open\"\u003e\n  \u003csummary id=\"#table-of-contents\"\u003eTable of Contents\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"#start\"\u003eGetting Started\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#apps\"\u003eApplications\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#libs\"\u003eLibraries\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#test\"\u003eTesting\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contribute\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#how-to-release\"\u003eHow to release (for maintainers)\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#help\"\u003eNeed help?\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n\u003ch2 id=\"start\"\u003e Getting Started \u003c/h2\u003e\n\nThis monorepo is the cornerstone for decentralized interfaces within the Tangle Network, incorporating a suite of dApps, including the revolutionary [Tangle Network](https://tangle.tools) applications. These applications are geared towards kickstarting advanced cryptographic developments and innovations in blockchain technology, leveraging multi-party computation (MPC) services and cross-chain capabilities.\n\nIt uses [nx.dev](https://nx.dev/) for fast and extensible building. The `apps` directory contains the protocol's interfaces while `libs` contains the necessary code and logic.\n\n### Prerequisites\n\nThis repository makes use of yarn, nodejs, and requires version node v18.18.x. To install node.js binaries, installers, and source tarballs, please visit https://nodejs.org/en/download/.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"apps\"\u003e Applications \u003c/h2\u003e\n\n- [tangle-dapp](./apps/tangle-dapp/README.md): the central hub to managing Tangle Network assets and MPC (Multi-Party Computation) services.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"libs\"\u003e Libraries \u003c/h2\u003e\n\n- `abstract-api-provider`: a collection of base and abstract classes that unify the API across multiple providers.\n- `api-provider-environment`: contains the React context definitions, the app event, and functions for handling interactive feedback errors for the bridge app.\n- `browser-utils`: contains all the browser utility functions, such as fetch with caching, download file and string, the customized logger class, get browser platform, and the storage factory function for interacting with local storage.\n- `dapp-config`: contains all configurations (chains, wallets, etc.) for the bridge dApp.\n- `dapp-types`: contains all the sharable TypeScript types and interfaces across the apps.\n- `icons`: contains all the sharable icons across the apps.\n- `polkadot-api-provider`: the Substrate (or Polkadot) provider for the bridge.\n- `tailwind-preset`: the TailwindCSS preset for all the apps.\n- `tangle-shared-ui`: the library contains the logic and UI components that specialize in the Tangle Network.\n- [ui-components](./libs/ui-components/README.md): a collection of reusable components for building interfaces quickly.\n- `web3-api-provider`: the EVM provider for the bridge.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"test\"\u003e Testing \u003c/h2\u003e\n\nThe following instructions outlines how to run Tangle dApp test suite.\n\n### To run tests\n\n```\nyarn test\n```\n\n### To start [Storybook](https://storybook.js.org/) for component library\n\n1. Install dependencies by `yarn`\n\n   ```bash\n   yarn install\n   ```\n\n2. Start the storybook:\n\n   ```bash\n   yarn nx storybook ui-components\n   ```\n\nVisit `http://localhost:4400/` to see the Tangle Component Library!\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"contribute\"\u003e Contributing \u003c/h2\u003e\n\nInterested in contributing to the Tangle dApp interface? Thank you so much for your interest! We are always appreciative for contributions from the open-source community!\n\nIf you would like to contribute, please refer to our [Contribution Guide](./.github/CONTRIBUTING.md) for instructions. We are excited for your first contribution!\n\n### Lint before you push!\n\nPlease ensure you lint and format your changes prior to opening a PR.\n\n**To lint:**\n\n```\nyarn lint\n```\n\n**To Format:**\n\n```\nyarn format\n```\n\n**To Build:**\n\n```\nyarn build\n```\n\nAdditionally, to ensure commit message consistency, this repository uses [commitlint](https://commitlint.js.org/#/). Please refer to the [Commit Message Guidelines](./.github/CONTRIBUTING.md#commit-message-guidelines) for more information.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"how-to-release\"\u003e How to release (for maintainers) \u003c/h2\u003e\n\nTo release a new version of the projects in this monorepo, follow these steps:\n\n1. Create a new branch from `develop`.\n2. Run `yarn run generate:release` to review the new bump version and the changelog.\n\n   2.1. To release specific projects, use `,` to separate the project names, use the `--projects` flag: `yarn run generate:release --projects=ui-components,other-project`, default is all projects.\n\n3. If everything looks good, run `yarn run generate:release -d=false` to apply changes, stage, and\n   commit them.\n\n   3.1. If you don't want to commit the changes, run `yarn run generate:release -d=false --gitCommit=false`. This will only update the version and changelog files.\n\n   3.2. There are a few options available for the `generate:release` script. You can check them by running `yarn run generate:release --help`.\n\n4. Push and open a PR to `develop`, the PR title should start with `[RELEASE]` in order to trigger the release workflow.\n5. After the PR is merged, the release workflow will sync the changes to the `master` branch if the commit message starts with `[RELEASE]` on the `develop` branch. The release workflow will also create a new release on GitHub.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"license\"\u003e License \u003c/h2\u003e\n\nLicensed under \u003ca href=\"LICENSE\"\u003eApache 2.0 license\u003c/a\u003e.\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache 2.0 license, shall be licensed as above, without any additional terms or conditions.\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n\n\u003ch2 id=\"help\"\u003e Need help? \u003c/h2\u003e\n\nIf you need help or you want to additional information please:\n\n- Refer to the [Tangle Network Official Documentation](https://docs.tangle.tools/).\n- If you have feedback on how to improve the dApp interface or you have a specific question? Check out the [Tangle dApp Feedback Discussion](https://github.com/tangle-network/feedback/discussions/categories/tangle-dapp) or [Tangle dApp Feedback Discussion](https://github.com/tangle-network/feedback/discussions/categories/dapp-feedback).\n- If you found a bug please [open an issue](https://github.com/tangle-network/dapp/issues/new/choose) or [join our Discord](https://discord.gg/jUDeFpggrR) server to report it.\n\n---\n\n**Follow us at**\n[![Follow Tangle on twitter](https://img.shields.io/twitter/follow/tangle_network.svg?style=social)](https://twitter.com/intent/follow?screen_name=tangle_network)\n[![Follow Webb on LinkedIn](https://img.shields.io/badge/LinkedIn-webbprotocol-blue?style=flat\u0026logo=linkedin\u0026logoColor=b0c0c0\u0026labelColor=363D44)](https://www.linkedin.com/company/webb-protocol/)\n\n---\n\n**Share** the project link with your network on social media.\n\n\u003ca href=\"https://www.linkedin.com/shareArticle?mini=true\u0026url=https%3A//github.com/tangle-network/dapp\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/twitter/url?label=LinkedIn\u0026logo=LinkedIn\u0026style=social\u0026url=https%3A%2F%2Fgithub.com%2Ftangle-network%2Fdapp\" alt=\"Share on LinkedIn\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/intent/tweet?text=%F0%9F%9A%80%20Explore%20%60tangle-network/dapp%60%20Monorepo%20on%20Github%3A%20https%3A//github.com/tangle-network/dapp\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/twitter/url?label=Twitter\u0026logo=X\u0026style=social\u0026url=https%3A%2F%2Fgithub.com%2Ftangle-network%2Fdapp\" alt=\"Shared on Twitter\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://t.me/share/url?text=%F0%9F%9A%80%20Explore%20%60tangle-network/dapp%60%20Monorepo%20on%20Github%3A%20your%20%23zeroKnowledgeApp%20in%20%23blockchain.%20Secure%2c%20efficient%20%23crypto%20interactions%20await!%0A%0ADive%20in%20%E2%9E%A1%EF%B8%8F%20https%3A//github.com/tangle-network/dapp%20%23TangleEcosystem\u0026url=https%3A%2F%2Fgithub.com%2Ftangle-network%2Fdapp\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/twitter/url?label=Telegram\u0026logo=Telegram\u0026style=social\u0026url=https%3A%2F%2Fgithub.com%2Ftangle-network%2Fdapp\" alt=\"Share on Telegram\"/\u003e\n\u003c/a\u003e\n\n\u003cdiv align=\"right\"\u003e\u003ca href=\"#table-of-contents\"\u003e↑ Back to top ↑\u003c/a\u003e\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangle-network%2Fdapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftangle-network%2Fdapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangle-network%2Fdapp/lists"}