Skip to content

Clarify when the import flow and Farcaster manifest are still needed #1248

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gizdusum wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Clarify when the import flow and Farcaster manifest are still needed #1248

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/mini-apps/quickstart/migrate-existing-apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,10 @@ description: Quickly migrate your existing app to a mini app, preview it in Base
* You have an existing web app
* You have a Base app account

<Warning>
This guide is for apps that still need the manifest-based Mini App flow. If your app is already registered on Base.dev and you are following the standard web app path, start with [Migrate to a Standard Web App](/mini-apps/quickstart/migrate-to-standard-web-app) first. That path does not require a Farcaster manifest for standard web app support in the Base App.
</Warning>


<Steps>
<Step title="Add the MiniApp SDK">
Expand Down Expand Up @@ -238,4 +242,3 @@ The `accountAssociation` fields in the manifest are used to verify ownership of
/>
</Step>
</Steps>

4 changes: 4 additions & 0 deletions docs/mini-apps/quickstart/migrate-to-standard-web-app.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ tag: "NEW"
After April 9, 2026, the Base App treats all apps as standard web apps regardless of Farcaster manifests. Use the migration paths below to get your app working correctly in the Base App.
</Warning>

<Tip>
If your app is already registered on Base.dev and works as a standard web app in the Base App, use this guide as your primary path. You do not need to go through the older "Import Mini App" flow unless you specifically need manifest-based Mini App features that still depend on `/.well-known/farcaster.json`.
</Tip>

<Tip>
**Using an AI coding agent?** Install the [Migration Skill](https://github.com/base/skills) to let your agent handle this migration automatically. Run `npx skills add base/skills` and ask your agent to migrate your Farcaster mini app to a standard web app.
</Tip>
Expand Down