Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.solanamobile.com/llms.txt

Use this file to discover all available pages before exploring further.

If you already have an app on Google Play, publishing it on the dApp Store is straightforward. The key differences are:
  • File format: The dApp Store requires an APK (Google Play uses AAB)
  • Signing key: You must use a separate signing key from Google Play
You cannot reuse your Google Play signing key for the dApp Store. Generate a new one.

1. Create a new signing key

Generate a keystore exclusively for the dApp Store:
keytool -genkey -v -keystore my-app-name.keystore \
  -alias my-app-name \
  -keyalg RSA \
  -keysize 2048 \
  -validity 10000
For a full understanding of how Android app signing works, see the official Android documentation.

2. Build a signed APK

Since you already have a build pipeline for Google Play, you need to configure a separate build variant that signs with your dApp Store keystore. Choose your framework below:
If you use EAS for Google Play builds, your Google Play keystore is managed by EAS. To use a separate keystore for the dApp Store, use credentialsSource: "local" so EAS reads your dApp Store keystore from a local credentials.json file instead.

1. Create a credentials.json

In your project root, create a credentials.json pointing to the dApp Store keystore you generated in step 1:
credentials.json
{
  "android": {
    "keystore": {
      "keystorePath": "./my-app-name.keystore",
      "keystorePassword": "your_keystore_password",
      "keyAlias": "my-app-name",
      "keyPassword": "your_key_password"
    }
  }
}
Add credentials.json to your .gitignore to avoid committing sensitive keystore passwords.

2. Add a dapp-store build profile

In your eas.json, add a dapp-store profile that builds an APK using your local credentials:
eas.json
{
  "build": {
    "production": {
      // ... your existing Google Play profile
    },
    "dapp-store": {
      "android": {
        "buildType": "apk",
        "credentialsSource": "local"
      }
    }
  }
}

3. Build the APK

eas build --platform android --profile dapp-store
EAS will use the keystore from your credentials.json instead of the EAS-managed Google Play keystore.

3. Submit to the dApp Store

With your signed APK ready, follow the standard publishing process:

Submit your app

Follow the step-by-step guide to submit your APK to the Solana dApp Store.
Last modified on February 13, 2026