Introduction

LunoKit is a React library that makes it easy to add Polkadot wallet connection to your dapp.

What is LunoKit?

LunoKit provides a fast, easy and highly customizable way for developers to add wallet connectivity to their Polkadot and Kusama applications. We handle the hard stuff so developers and teams can focus on building amazing products and experiences.

Out of the box, LunoKit provides:

• 🔌 Multi-wallet Support - Support for major Polkadot ecosystem wallets with unified API
• ⚡ TypeScript First - Full type safety and IntelliSense support out of the box
• 🎨 Customizable UI - Beautiful components with flexible theming and styling options
• 📱 Responsive Design - Mobile-first UI components that work perfectly on all devices
• 🌐 Multi-chain Ready - Polkadot, Kusama, parachains and custom chain support
• ⚙️ React Hooks - Modern React patterns with comprehensive hook library

Supported Wallets

LunoKit supports all major Polkadot ecosystem wallets:

• Polkadot{.js} - The original Polkadot wallet browser extension
• SubWallet - Comprehensive wallet for Polkadot and Substrate ecosystems
• Talisman - Beautiful, user-friendly Polkadot wallet
• Nova Wallet - Mobile-first Polkadot wallet
• PolkaGate - Feature-rich Polkadot wallet extension
• WalletConnect - Protocol for connecting wallets across devices

Supported Chains

Works with all Substrate-based chains:

• Polkadot - The main Polkadot relay chain
• Kusama - Polkadot's canary network
• Westend - Polkadot testnet
• Paseo - Community testnet
• Parachains - All Polkadot and Kusama parachains
• Custom Chains - Any Substrate-based blockchain

Architecture

LunoKit is built with a modular architecture:

• @luno-kit/core - Core connectors and chain configurations
• @luno-kit/react - React hooks and providers for state management
• @luno-kit/ui - Pre-built UI components with theming support

This modular approach allows you to use only what you need:

• Use @luno-kit/ui for a complete solution with beautiful UI components
• Use @luno-kit/react alone if you want to build custom UI with our hooks
• Extend @luno-kit/core to add custom wallets or chains

Getting Started

Ready to get started? Check out our installation guide or try our live demo.

Community & Support

• GitHub: Luno-lab/LunoKit
• Issues: Report bugs or request features
• License: MIT License

Contributing

LunoKit is open source and we welcome contributions! Check out our GitHub repository to get started.