Safe Apps SDK

The Safe Apps SDK helps developers to build their dapps into the Safe{Wallet}. It turns a dapp into an HTML iframe component that can be accessed through Safe. This SDK provides extensive developer tooling to make it easy to create, test, and integrate Safe Apps into Safe. This includes a design system, reusable components, and a Safe App SDK that facilitates communication between the Safe App and Safe.


Here are several packages to make it easier to integrate third-party applications (Safe Apps) with Safe (opens in a new tab). Check the following diagram to see which package is suitable for you:

diagram Safe Apps

cra-template-safe-app (opens in a new tab)CRA (Create React App) template to bootstrap a Safe App. Use this package to start a new Safe App from scratch using React.
safe-apps-react-sdk (opens in a new tab)npm (opens in a new tab)A wrapper of safe-apps-sdk (opens in a new tab) with helpful React Hooks.
safe-apps-sdk (opens in a new tab)npm (opens in a new tab)JavaScript SDK. This is the base package for all integrations.
safe-apps-provider (opens in a new tab)npm (opens in a new tab)A generic provider that can be used with common web3 libraries. For example, web3.js or Ethers.
safe-apps-web3modal (opens in a new tab)npm (opens in a new tab)A wrapper around Web3Modal (opens in a new tab) that would automatically connect to the Safe when the app is loaded in the Safe Apps section.
safe-apps-wagmi (opens in a new tab)A wagmi (opens in a new tab) connector for Safe Apps.
@web3-onboard/gnosis (opens in a new tab)Blocknative included Safe App support in @web3-onboard (opens in a new tab) v1.26.0. If you are already using this package, you can check here (opens in a new tab) how to configure it.
@web3-react/gnosis-safe (opens in a new tab)web3-react (opens in a new tab) already includes a connector for Safe Apps by default. You can check their docs on how to use it.

Safe Apps aren't owned, controlled, maintained, or audited by Safe. Safe can list or delist apps from Safe{Wallet} at its sole discretion.