NFID IdentityKit is a React library designed to simplify adding a wallet connection to your decentralized application (dApp). With intuitive, responsive, and customizable components, developers can easily select which ICP-compatible wallets to support in their apps for authentication, signatures, and transfers.

• Easy Integration: Quickly add wallet connection functionality to your dApp.
• Customizable: Tailor the look and feel to match your application's design.
• Responsive: Optimized for different screen sizes and devices.

Before using NFID IdentityKit, ensure that you have:

• An ICP project with a frontend canister.

To install IdentityKit, you'll need the following libraries:

• @nfid/identitykit - A library to integrate compatible ICP wallets into your application.
• @nfid/identitykit/react - A library containing React-specific components for integrating compatible ICP wallets into your application.

Install both with the following command:

npm install @nfid/identitykit @nfid/identitykit/react

IdentityKit requires certain peer dependencies to function correctly. Ensure the following packages are installed in your project:

npm install @dfinity/ledger-icp @dfinity/identity @dfinity/agent @dfinity/candid @dfinity/principal @dfinity/utils @dfinity/auth-client

Note: IdentityKit is a React library and exports styles that need to be imported into your project.

Begin by importing the necessary styles in your project:

import "@nfid/identitykit/react/styles.css"

Next, wrap your entire application with the IdentityKitProvider to enable wallet connections:

import { IdentityKitProvider } from "@nfid/identitykit/react"

const App = () => {
  return (
    <IdentityKitProvider>
      <YourApp />
    </IdentityKitProvider>
  )
}

Finally, import and render the ConnectWallet component in your application to allow users to connect their wallets:

import { ConnectWallet } from "@nfid/identitykit/react"

export const YourApp = () => {
  return <ConnectWallet />
}

Once integrated, IdentityKit will handle your user's wallet selection, display wallet information, and manage wallet switching.

This project is licensed under the MIT License.

Contributions are welcome! To get started, please submit a pull request or open an issue on GitHub.

If you encounter any issues or have questions, feel free to reach out to the team directly on Discord.