> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate your OnchainKit App

> How to migrate your OnchainKit app to wagmi and viem using the Base migration skill.

OnchainKit is no longer maintained. This guide helps you migrate your existing OnchainKit app to a standalone [wagmi](https://wagmi.sh) project using the Base migration skill.

## Overview

The skill handles three components: `OnchainKitProvider`, `Wallet`, and `Transaction`. For each it:

* Deletes existing OnchainKit component code from your project
* Creates new wagmi/viem-based replacement files
* Logs any errors in a `mistakes.md` file at your project root

## Prerequisites

* A Next.js or React project using OnchainKit
* An AI coding assistant that supports skills (Claude Code or Cursor)

## Install the Skill

```bash theme={null}
npx skills add base/base-skills
```

## Migration Prompts

<Warning>
  If migrating individually, start with the Provider prompt below. The wallet and transaction components depend on `WagmiProvider` being implemented first.
</Warning>

### One-Shot (all three components)

```text theme={null}
Migrate my OnchainKit app to use standalone wagmi and viem. Replace the provider, wallet component, and transaction component. Remove the OnchainKit dependency entirely.
```

### Provider

```text theme={null}
Replace my OnchainKitProvider with WagmiProvider and QueryClientProvider.
```

### Wallet

```text theme={null}
Migrate my OnchainKit wallet component to a standalone wagmi-based connect button.
```

### Transaction

```text theme={null}
Migrate my OnchainKit transaction component to use wagmi hooks directly.
```

## Verify

After migration, run this prompt to confirm the three migrated components are fully replaced:

```text theme={null}
Run npm run build and confirm there are no remaining imports of OnchainKitProvider, Wallet, or Transaction from @coinbase/onchainkit in the project.
```