Socket Plugin
Seamless bridging experience into a single fully customizable React Component
Socket Plugin is a React component that can be easily imported in any React (JS/TS) project. The plugin supports most features from [Bungee.exchange](https://bungee.exchange/). It brings the seamless bridging UX from Bungee to any DApp!
The plugin requires `provider` from user’s connected wallet & Socket’s `API_KEY` as props to initialise. [Optional props](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790) can be passed to customize the plugin’s color scheme, pre-select the chains/tokens & also customize token lists.
The full documentation for the plugin can be found [here](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790)
## Installation
The plugin can be installed via NPM or Yarn.
**NPM :**
```bash
npm install @socket.tech/plugin
```
**Yarn :**
```bash
yarn add @socket.tech/plugin
```
**Note :** The plugin requires `react` (>=17.0.1) and `react-dom` (>=17.0.1) as peerDepencies.
## Initialization
Copy the snippet below to get started! Pass the `API_KEY` from a .env file and `Provider` from user’s connected wallet.
```tsx
import { Bridge } from "@socket.tech/plugin";
import { Provider } from "./providerComponent"
function SocketBridge() {
return (
)
}
export default SocketBridge;
```
That’s it! You’ve successfully plugged your DApp into Socket! 🔌 For further customising the plugin, check the plugin [docs](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790).
## Documentation
- [Initialisation](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790)
- [Customisation](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790)
- [API reference](https://www.notion.so/Socket-Widget-Docs-b905871870e343c6833169ebbd356790)
## Example App
Work In Progress 🛠
## More themes... 😎
