Home

IC Reactor Wiki

This wiki is a repo-oriented companion to the main documentation site.

• Canonical docs: https://ic-reactor.b3pay.net/v3/
• Repository: https://github.com/B3Pay/ic-reactor

What IC Reactor Is

IC Reactor is a set of libraries for building Internet Computer applications with:

• end-to-end TypeScript types
• TanStack Query-powered caching and invalidation
• React hook factories like createActorHooks(...)
• reusable query and mutation factories
• display-friendly transforms through DisplayReactor
• optional code generation through the CLI and Vite plugin

Start Here

• Getting Started for installation and first setup
• Package Overview for the package map
• React Patterns for the main integration styles
• Code Generation for the Vite plugin, CLI, and manual declaration flows
• Local Development for icp-cli, ic_env, and manual dfx notes
• Dynamic Candid for runtime canister exploration and metadata-driven forms
• Examples for the fastest way to find a working reference app

Recommended Setup

For most React apps:

pnpm add @ic-reactor/react @icp-sdk/core @tanstack/react-query
pnpm add -D @ic-reactor/vite-plugin

Then create:

// src/clients.ts
import { ClientManager } from "@ic-reactor/react"
import { QueryClient } from "@tanstack/react-query"

export const queryClient = new QueryClient()
export const clientManager = new ClientManager({
  queryClient,
  withCanisterEnv: true,
})

And configure the Vite plugin:

// vite.config.ts
import { defineConfig } from "vite"
import react from "@vitejs/plugin-react"
import { icReactor } from "@ic-reactor/vite-plugin"

export default defineConfig({
  plugins: [
    react(),
    icReactor({
      canisters: [{ name: "backend", didFile: "./backend/backend.did" }],
    }),
  ],
})

Use This Wiki For

• quick architectural orientation
• deciding which package or pattern to use
• finding the right example quickly
• repo-specific workflows

Use the main docs site for full API reference and deeper guides.