1.2.5 • Published 4 months ago
@xellar/kit v1.2.5
Xellar-kit
Xellar-kit is a plug-and-play wallet connection solution designed for seamless integration with Xellar Passport and various other wallets, including MetaMask (injector) and WalletConnect. It provides a smooth developer experience for integrating multi-wallet authentication into decentralized applications (dApps).
Features
- 🔌 Xellar Passport Integration – Seamlessly authenticate users via Xellar Passport.
- 🦊 MetaMask (Injected Wallets) Support – Detect and connect to browser extension wallets.
- 📲 WalletConnect Integration – Connect to mobile wallets with QR code scanning.
- 🛠 Customizable UI – Easily theme and configure the modal to fit your dApp.
- ⚡ Developer-Friendly API – Simple hooks and components for quick integration.
Installation
npm install @xellar/kit
# or
yarn add @xellar/kit
Usage
Basic Setup
import React from "react";
import { Config, WagmiProvider } from "wagmi";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { XellarKitProvider, defaultConfig, darkTheme, ConnectButton } from "@xellar/kit";
const walletConnectProjectId = process.env.VITE_WALLET_CONNECT_PROJECT_ID;
const config = defaultConfig({
appName: "Xellar",
walletConnectProjectId,
xellarAppId: process.env.VITE_XELLAR_APP_ID,
xellarEnv: "sandbox",
}) as Config;
const queryClient = new QueryClient();
export const Provider = ({ children }: { children: React.ReactNode }) => {
return (
<WagmiProvider config={config}>
<QueryClientProvider client={queryClient}>
<XellarKitProvider
theme={darkTheme}
googleClientId={process.env.VITE_GOOGLE_CLIENT_ID}
telegramConfig={{
botId: process.env.VITE_TELEGRAM_BOT_ID,
botUsername: process.env.VITE_TELEGRAM_BOT_USERNAME,
}}
>
{children}
</XellarKitProvider>
</QueryClientProvider>
</WagmiProvider>
);
};
function MyComponent() {
return (
<div>
<ConnectButton />
</div>
);
}
API
<XellarKitProvider>
Wrap your application with XellarKitProvider
to enable wallet connection features.
Supported Wallets
- Xellar Passport (native integration)
- MetaMask (Injected Web3 Wallets)
- WalletConnect (QR code-based connection)
Customization
Xellar-kit allows styling and theming via props and CSS variables. More details on theming options coming soon!
Roadmap
- 🔹 Integration with Solana wallets
- 🔹 Other multi-chain support for EVM & non-EVM networks
Contributing
Contributions are welcome! Open an issue or submit a pull request to get started.
License
Apache 2.0 License. See LICENSE
for details.