convert-farcaster-miniapp-to-app
Convert Farcaster Miniapp to Base App
Convert a Farcaster miniapp into a normal app on Base. The default outcome is a regular web app that works in the Base app browser and on the open web, with Farcaster Mini App host coupling removed.
If some Farcaster functionality truly needs to survive, keep it separate from the main app surface. Prefer read-only data first. Only preserve Mini App-specific behavior when the user explicitly insists, and isolate it behind a dedicated route or page rather than carrying it through the whole app.
Core Principle
Always separate these decisions:
- Remove Mini App host/runtime coupling.
- Decide whether any Farcaster-facing functionality should remain.
- If something remains, keep it isolated from the main app and avoid introducing new vendor dependencies by default.
Do not automatically turn "keep some Farcaster functionality" into "migrate to Neynar." If a project already uses Neynar and the user wants to keep an isolated Farcaster-only area, you may preserve that existing integration. Do not introduce new Neynar adoption as the default recommendation.
Quick Start
Follow these five phases sequentially: