converting-minikit-to-farcaster

Migrate Farcaster Mini Apps from MiniKit to the native Farcaster SDK.

104|114|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/base/skills --skill converting-minikit-to-farcaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: converting-minikit-to-farcaster
Source: https://github.com/base/skills/tree/main/skills/converting-minikit-to-farcaster
Command: npx skills add https://github.com/base/skills --skill converting-minikit-to-farcaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @farcaster/miniapp-sdk, @farcaster/miniapp-wagmi-connector, wagmi, @tanstack/react-query, and includes references (resource) components.

What problem does it solve?

This Skill helps developers migrate their existing Farcaster Mini Apps from the older MiniKit (OnchainKit) library to the newer, native Farcaster SDK, ensuring compatibility and access to the latest features.

Core Features & Use Cases

  • Automated Code Conversion: Provides clear mappings and examples for replacing MiniKit hooks with Farcaster SDK equivalents.
  • Dependency Management: Guides users on updating necessary npm packages.
  • Provider Setup: Details how to replace MiniKitProvider with FrameProvider and WagmiProvider.
  • Use Case: A developer has a Farcaster Mini App built with @coinbase/onchainkit/minikit and needs to update it to use the latest @farcaster/miniapp-sdk to maintain functionality and adopt new features.

Quick Start

Follow the conversion workflow outlined in the SKILL.md file to migrate your Mini App.

Frequently Asked Questions about converting-minikit-to-farcaster

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Farcaster Mini App from MiniKit to the native Farcaster SDK?

To migrate a Farcaster Mini App from MiniKit to the native Farcaster SDK, replace MiniKit hooks with Farcaster SDK equivalents, update npm dependencies, and swap MiniKitProvider with FrameProvider and WagmiProvider.

What breaking changes do I need to watch for when upgrading to the Farcaster SDK v0.2.0+?

Upgrading to Farcaster SDK v0.2.0+ introduces breaking changes in provider setups and specific hooks. The migration requires replacing the old OnchainKit minikit hooks with their new native equivalents and adjusting your dependency tree.

How do I replace MiniKitProvider with FrameProvider and WagmiProvider during SDK migration?

Replacing MiniKitProvider during SDK migration involves configuring your application with FrameProvider and WagmiProvider. This setup ensures your Mini App maintains wallet connectivity and native Farcaster functionality.

Do I need wagmi and tanstack react-query to use the Farcaster miniapp SDK?

Yes, the Farcaster miniapp SDK utilizes wagmi, the miniapp-wagmi-connector, and tanstack react-query as core dependencies to manage onchain interactions and data fetching within your migrated Mini App.

Can I use my existing OnchainKit minikit hooks after migrating to the Farcaster miniapp SDK?

No, existing OnchainKit minikit hooks must be converted to their native Farcaster miniapp SDK equivalents. The migration provides detailed mapping and examples to help you transition these specific hooks successfully.

Why is my Farcaster Mini App not working after updating to the native SDK?

Your Farcaster Mini App may not work after updating to the native SDK due to unresolved breaking changes in provider setup or outdated dependencies. Use the provided troubleshooting guidance to map remaining hooks correctly.