Overview

DreamOS86 supports publishing web apps to the Play Store using Trusted Web Activities (TWA) via Capacitor. The flow is:

Build your web app

Wrap it in a TWA shell

Generate a signed APK/AAB

Upload to Play Console

Step 1: Configure your package ID

Your app's package ID must be unique (e.g. com.yourcompany.yourapp). Set it in your project settings:

Settings → Mobile → Package ID

Step 2: Generate your SHA256 fingerprints

You need three fingerprints for full Play Store compatibility:

To get your Play App Signing fingerprint:

Play Console → Your app → Release → Setup → App signing

Copy the SHA256 certificate fingerprint

Add all three to Settings → Mobile → SHA256 Fingerprints.

Step 3: Configure TWA manifest

The TWA manifest links your Android app to your web domain. Add to assetlinks.json:

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.yourcompany.yourapp",
    "sha256_cert_fingerprints": [
      "YOUR_PLAY_APP_SIGNING_SHA256",
      "YOUR_UPLOAD_KEY_SHA256"
    ]
  }
}]

Host this at https://yourdomain.com/.well-known/assetlinks.json.

Step 4: Build and upload

From the Deploy tab:

Select your project

Click Build for Android

Download the AAB file

Upload to Play Console → Production

Troubleshooting

"Digital Asset Links verification failed"

→ Check that /.well-known/assetlinks.json is publicly accessible and contains the correct SHA256.

App shows as browser, not TWA

→ Asset links file is missing or has wrong fingerprints. Check all three SHA256 values.

"Package name already taken"

→ Choose a different package ID. Once published, it cannot be changed.