InterwovenKit

See README.md for detailed package documentation.

Table of Contents

• Installation
• Configuration
• Running Locally
• Tech Stack
• Project Structure
• Scripts

Installation

git clone https://github.com/initia-labs/interwovenkit.git
cd interwovenkit
pnpm i
pnpm build  # Build the package at least once before running in development mode

Configuration

cd examples/vite
cp .env.development .env.development.local  # Toggle between mainnet and testnet in this file

INITIA_NETWORK_TYPE=mainnet  # Network Configuration

Running Locally

Development Mode

Run the demo site directly from your local source with hot module replacement (HMR):

pnpm dev

• The package source files will be injected into the portal element in the document body.
• The demo site will be available at: http://localhost:5173

Production Mode

After making changes to the package, rebuild and run the demo using the compiled output:

pnpm build  # Rebuild the package after any changes.
pnpm watch  # Serve the demo using the built package and styles.

• In production mode, the package and its styles will be injected into a Shadow DOM.
• The demo site will be available at: http://localhost:5173

Tech Stack

Core Framework

• React 19
• Vite

State Management

• Jotai
• TanStack Query
• React Hook Form

Blockchain Integration

• CosmJS
• wagmi

UI & Styling

• CSS Modules
• React Spring
• Radix UI

Utilities

• ky
• date-fns
• ramda
• BigNumber.js

Project Structure

packages/interwovenkit-react/src/
├── public/          # Public API exports
├── lib/             # Utilities and router
├── data/            # Core blockchain logic
├── hooks/           # Custom React hooks
├── components/      # Reusable UI components
├── pages/           # UI pages
└── styles/          # Global styles

Core Components

• <InterwovenKitProvider />: The main provider component that wraps your application and provides all necessary contexts for wallet integration.
• useInterwovenKit(): Primary hook for accessing wallet and bridge functionality.

Scripts

pnpm dev
pnpm build
pnpm typecheck
pnpm lint
pnpm test