Skip to content

Android APK blank screen: no Gatekeeper URL in production build #180

@macterra

Description

@macterra

Problem

The GitHub Actions release workflow (android-debug-build-release.yml) builds the APK with vite build --mode production, but there is no .env.production file committed — only .env.production.example. This means VITE_GATEKEEPER_URL is undefined in the built APK.

On a physical device, the app can't reach any Gatekeeper and renders a blank screen. (.env.android uses 10.0.2.2 which only works in the Android emulator.)

Options

  1. Commit a .env.production with a default public Gatekeeper URL (e.g. https://4tress.org)
  2. Use GitHub Actions secrets to inject VITE_GATEKEEPER_URL at build time
  3. Change android:build to use --mode android and update .env.android with a public URL
  4. Add a settings screen in the app so users can configure the Gatekeeper URL at runtime

Files

  • .github/workflows/android-debug-build-release.yml — build workflow
  • apps/react-wallet/.env.android — emulator-only config (10.0.2.2)
  • apps/react-wallet/.env.production.example — template, not used in build
  • apps/react-wallet/package.jsonandroid:build script uses --mode production

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions