Files
easy-wallet/frontend
Davide Grilli 5a390841f4 feat(dev): add Android live-reload workflow with SDK autodetection
- Add root dev:android script delegating to frontend
- Add Android dev scripts and wrapper to resolve ANDROID_SDK_ROOT/ANDROID_HOME (Linux/WSL)
- Keep Vite running when Android run fails and document troubleshooting in frontend README
- Ignore generated frontend/android project in git
2026-03-10 16:02:59 +01:00
..

Frontend (Electron + Android)

Prerequisites

  • Node.js and npm
  • Android SDK + adb + an emulator or connected device (for Android dev mode)

Install dependencies

From repository root:

cd frontend
npm ci

Development

From repository root:

npm run dev

This starts desktop development mode (Vite + Electron).

From repository root:

npm run dev:android

This starts Android live-reload development mode:

  • Ensures frontend/android exists (cap add android on first run only)
  • Starts Vite on 0.0.0.0:5173
  • Runs cap run android -l --no-sync --port 5173 --forwardPorts 5173:5173

Troubleshooting (Android SDK)

If you get:

ERR_SDK_NOT_FOUND: No valid Android SDK root found.

set one of these environment variables and run again:

export ANDROID_SDK_ROOT="/path/to/Android/Sdk"
# or
export ANDROID_HOME="/path/to/Android/Sdk"

Typical locations:

  • Linux: $HOME/Android/Sdk
  • WSL + Android Studio on Windows: /mnt/c/Users/<windows-user>/AppData/Local/Android/Sdk

Other scripts

From frontend/:

npm run build
npm run preview
npm run cap:sync
npm run dist