{"id":20078706,"url":"https://github.com/wpdas/near-social-bridge","last_synced_at":"2025-05-05T22:32:53.705Z","repository":{"id":143570316,"uuid":"616097397","full_name":"wpdas/near-social-bridge","owner":"wpdas","description":"This library allows you to create a common application using ReactJS and use it inside a BOS Component. Therefore, the BOS Component talks to the React application and vice versa, making it possible to consume Discovery API resources within the React application. Link to real-time tests below:","archived":false,"fork":false,"pushed_at":"2024-02-23T02:17:59.000Z","size":1193,"stargazers_count":20,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T07:38:36.946Z","etag":null,"topics":["blockchain","bos","bridge","library","near","os","react","reactjs","social","widget"],"latest_commit_sha":null,"homepage":"https://near.org/wendersonpires.near/widget/NearSocialBridgeTests","language":"TypeScript","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/wpdas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-03-19T15:51:43.000Z","updated_at":"2024-12-20T12:33:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"675d4665-6e40-410e-a4db-5d9f56ebea3f","html_url":"https://github.com/wpdas/near-social-bridge","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wpdas%2Fnear-social-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wpdas%2Fnear-social-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wpdas%2Fnear-social-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wpdas%2Fnear-social-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wpdas","download_url":"https://codeload.github.com/wpdas/near-social-bridge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252586367,"owners_count":21772285,"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","bos","bridge","library","near","os","react","reactjs","social","widget"],"created_at":"2024-11-13T15:16:17.126Z","updated_at":"2025-05-05T22:32:53.319Z","avatar_url":"https://github.com/wpdas.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cdiv style=\"display: flex; align-items: center; gap: 8px;\"\u003e\u003cimg src='./md/near-social-bridge-logo.png' height='27' alt='NEAR Social Bridge Logo' /\u003e NEAR Social Bridge\u003c/div\u003e\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/wpdas/near-social-bridge/publish.yml?style=for-the-badge\u0026colorB=000000)](https://github.com/wpdas/near-social-bridge/actions?query=workflow%3Apublish)\n[![Build Size](https://img.shields.io/bundlephobia/minzip/near-social-bridge/1.0.1?label=bundle%20size\u0026style=for-the-badge\u0026colorB=000000)](https://bundlephobia.com/package/near-social-bridge)\n[![Version](https://img.shields.io/npm/v/near-social-bridge?style=for-the-badge\u0026colorB=000000)](https://www.npmjs.com/package/near-social-bridge)\n[![Downloads](https://img.shields.io/npm/dt/near-social-bridge.svg?style=for-the-badge\u0026colorB=000000)](https://www.npmjs.com/package/near-social-bridge)\n![Tests](https://near-social-bridge-tests.vercel.app/api/tests-passing)\n\nThis library allows you to create a common application using ReactJS and use it inside a BOS Component. Therefore, the BOS Component talks to the React application and vice versa, making it possible to consume the [Blockchain Operating System](https://docs.near.org/bos/overview#) resources within the React application.\n\nPlease consider making a donation if you liked this project.\n\n\u003ca href=\"https://bos.potlock.org/?tab=project\u0026projectId=near-social-bridge.near\" target=\"_blank\"\u003e\n  \u003cimg src='./md/assets/donate.png' alt='Near Logo' /\u003e\n\u003c/a\u003e\n\n## Live Apps \u0026 Tutorials\n\nCheck out some apps using Near Social Bridge:\n\n- [NEAR Query API](https://github.com/near/queryapi/tree/main/frontend)\n- [Chat App](https://github.com/wpdas/chatv2-near-widget-app)\n\nTutorials:\n\n- [Greeting App](https://github.com/wpdas/near-social-bridge/tree/main/examples/greeting-app)\n- [Todo App](https://github.com/wpdas/near-social-bridge/tree/main/examples/todo-app)\n- [SSR NextJS Test App](https://github.com/wpdas/nextjs-near-widget-app)\n- [Decentralized App - Tutorial](./examples/dapp-bos-tutorial/TUTORIAL.md)\n\n## Install\n\nInstall it using npm or yarn:\n\n```sh\n# npm\nnpm install near-social-bridge\n\n# yarn\nyarn add near-social-bridge\n```\n\n## How to Use\n\nHere's a complete guide where you can go over all features provided by Near Social Bridge.\n\n### Main Features\n\n- [Setup](./md/setup.md)\n- [BOS API](./md/bos-api.md)\n  - [Near API](./md/bos-api.md#near-api)\n  - [Social API](./md/bos-api.md#social-api)\n  - [Storage API](./md/bos-api.md#storage-api)\n  - [Fetch API](./md/bos-api.md#fetch-api)\n- [Requests](./md/requests.md)\n  - [Simple Request](./md/requests.md#simple-request)\n  - [Handling requests inside the BOS Component](./md/requests.md#handling-requests-inside-the-bos-component)\n  - [Using request Utils inside the BOS Component](./md/requests.md#using-request-utils-inside-the-bos-component)\n  - [Requests - Concurrency](./md/requests.md#requests---concurrency)\n- [Components](./md/components.md)\n- [Hooks](./md/hooks.md)\n  - [useNearSocialBridge](./md/hooks.md#usenearsocialbridge)\n  - [useConnectionStatus](./md/hooks.md#useconnectionstatus)\n  - [useInitialPayload](./md/hooks.md#useinitialpayload)\n  - [useAuth](./md/hooks.md#useauth)\n  - [useWidgetView](./md/hooks.md#usewidgetview)\n  - [useSyncContentHeight](./md/hooks.md#usesynccontentheight)\n- [Preparing a new BOS Component](./md/preparing-new-bos-component.md)\n- [Testing the Application with Local Viewer](./md/testing-app-with-local-viewer.md)\n\n### Extra Features\n\n- [Database](./md/database.md)\n- [Mock](./md/mock.md)\n  - [Setup Mocks](./md/mock.md#setup-mocks)\n  - [Mock Authenticated User](./md/mock.md#mock-authenticated-user)\n  - [Mock Initial Payload](./md/mock.md#mock-initial-payload)\n  - [Create Requests Mocks](./md/mock.md#create-requests-mocks)\n- [Navigation](./md/navigation.md)\n  - [Implementing routes](./md/navigation.md#implementing-routes)\n- [Session Storage](./md/session-storage.md)\n- [Persist Storage](./md/persist-storage.md)\n- [BOSComponent - experimental](./md/experimental.md#boscomponent)\n- [Hooks](./md/hooks.md)\n  - [useBOSComponent - experimental](./md/experimental.md#useboscomponent)\n  - [useNavigation](./md/hooks.md#usenavigation)\n  - [useSessionStorage](./md/hooks.md#usesessionstorage)\n- [Utils](./md/utils.md)\n  - [initRefreshService](./md/utils.md#initrefreshservice)\n  - [overrideLocalStorage](./md/utils.md#overridelocalstorage)\n\n## React / Next App Deployment\n\nYou can deploy your app in two ways: decentralized or centralized.\n\n- [Deploying to IPFS (CSR) - Decentralized](./md/deploying-to-ipfs-csr.md)\n- [Deploying to Vercel (SSR)](./md/deploying-to-vercel-ssr.md)\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](./CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwpdas%2Fnear-social-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwpdas%2Fnear-social-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwpdas%2Fnear-social-bridge/lists"}