-
Notifications
You must be signed in to change notification settings - Fork 530
Open
Description
I ran into a confusing onboarding path while trying to register an existing app on Base.dev and import it as a Mini App.
What made it hard to follow is that the docs currently point in two different directions:
docs/mini-apps/quickstart/migrate-to-standard-web-app.mdxsays that after April 9, 2026 the Base App treats apps as standard web apps, and that Farcaster manifests are no longer required for that path.docs/mini-apps/quickstart/migrate-existing-apps.mdxand the manifest docs still guide developers through adding/.well-known/farcaster.json, generatingaccountAssociation, and using the "Import Mini App" flow.
In practice, this left me unsure about:
- when
/.well-known/farcaster.jsonis still actually required - when Base.dev metadata is enough by itself
- whether the "Import Mini App" flow is optional, legacy, or still required for some apps
- which path should be followed for an app that is already live as a standard web app and already verified on Base.dev
I was able to get as far as verifying ownership and serving the manifest correctly, but the flow still felt ambiguous because the docs suggest both:
- "no Farcaster manifest required" for standard web apps
- "add a Farcaster manifest and import your mini app"
A simple decision tree or clarification at the top of these pages would help a lot.
Suggested improvement:
- add a short "Which flow should I use?" section to both pages
- explicitly label the manifest/import path as required only for Mini Apps that still need that flow
- explicitly label the standard web app path as the default path for new Base App registrations if that is the intended experience
Relevant docs pages:
docs/mini-apps/quickstart/migrate-to-standard-web-app.mdxdocs/mini-apps/quickstart/migrate-existing-apps.mdxdocs/mini-apps/core-concepts/manifest.mdx
Happy to open a docs PR for this if helpful.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels