Skip to content

docs: clarify Mini App vs Standard Web App migration paths#1252

Open
Kubudak90 wants to merge 1 commit intobase:masterfrom
Kubudak90:clarify-migration-paths
Open

docs: clarify Mini App vs Standard Web App migration paths#1252
Kubudak90 wants to merge 1 commit intobase:masterfrom
Kubudak90:clarify-migration-paths

Conversation

@Kubudak90
Copy link
Copy Markdown

Summary

This PR addresses the confusion reported in #1247 about when Mini App import + Farcaster manifest are still required vs when the new Standard Web App flow should be used.

Changes

migrate-to-standard-web-app.mdx

  • Added a "Which migration path should I use?" decision tree section at the top
  • Clear table showing when Farcaster manifest is required vs optional
  • Explicit guidance that as of April 9, 2026, most apps should use the Standard Web App flow
  • Direct link to the legacy flow for apps that specifically need Farcaster integration

migrate-existing-apps.mdx

  • Added prominent deprecation warning at the top
  • Clarified this is the legacy flow for Farcaster-specific features only
  • Added reference to the new Standard Web App flow as the recommended alternative
  • Added "Alternative: Standard Web App Flow" section at the bottom

Why this helps

The current docs have two different pages with conflicting information:

  • migrate-to-standard-web-app.mdx says "no Farcaster manifest required"
  • migrate-existing-apps.mdx still guides through manifest/import flow

This leaves developers unsure which path to follow. The changes add:

  1. A decision tree to help developers choose the right path
  2. Clear deprecation notice on the legacy page
  3. Cross-links between both pages for easy navigation

Fixes #1247

Add a decision tree section to help developers understand:
- When Farcaster manifest is required vs optional
- Which migration path to choose based on their app type
- Clear distinction between legacy Mini App flow and new Standard Web App flow

Also add deprecation notice to migrate-existing-apps.mdx directing users
to the new standard web app flow for most use cases.

Fixes base#1247
@cb-heimdall
Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/2
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs are unclear about when Mini App import + farcaster manifest are still required

2 participants