Skip to content

Added Compatability section #50

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.

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
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
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
51 changes: 51 additions & 0 deletions docs/wallet-app/introduction/mini-apps.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -201,3 +201,54 @@ You can self-host your own backend as long as it follows the [Farcaster Mini App
- Posting events to the expected format
</Tab>
</Tabs>

## Mini Apps Compatibility in Coinbase Wallet

Coinbase Wallet is working towards full compatibility with the Farcaster Mini App SDK. While we continue to enhance support during the beta phase, there are currently some features that are not yet supported.

### AI-Powered Compatibility Checking
We provide a [validate.txt](https://raw.githubusercontent.com/base/demos/refs/heads/master/minikit/mini-app-help/validate.txt) file that can be used with AI tools to automatically check your codebase for Coinbase Wallet compatibility issues. Similar to llms.txt files, you can provide this validation file to language models to scan your Mini App code and receive a detailed compatibility report highlighting any unsupported features or patterns.

<Warning>
This AI validation is experimental and should only be used in a read-only capacity for analysis and reporting purposes.
</Warning>

### Currently Unsupported Features

The following Mini App SDK features are **not currently supported** in Coinbase Wallet:

#### Environment Detection

* `sdk.isInMiniApp()`

#### Haptic Feedback

* All haptic-related SDK methods

#### Token Actions

* `sdk.actions.swapToken` \- Token swapping functionality
* `sdk.actions.sendToken` \- Token sending functionality
* `sdk.actions.viewToken` \- Token viewing functionality

#### Navigation & Links

* Direct HTML links (`<a href=`, `<Link href=`)
* Warpcast composer URLs (`warpcast.com/~/compose`, `farcaster.com/~/compose`)

#### Context Features

* `Share extensions` \- Because share extensions heavily rely on context this will not work in CBW.
* `sdk.context.location` \- Share link detection and embed context


### Development Notes

* Use `sdk.actions.openUrl()` for external navigation instead of direct HTML links
* Use `sdk.actions.composeCast()` instead of Warpcast composer URLs
* Implement visual feedback alternatives for haptic feedback
* Avoid relying on location context for core functionality
* To conditionally render functionality based on the user's client, check context.client.clientFid (Coinbase Wallet returns 399519)

We are actively working to expand compatibility and expect to support additional features in future releases.