HandigoIO

This branch (packagemerge) runs HandiGo as a Tauri desktop app with:

• Frontend: Vite (handigo_app/frontend_client/Handigo)
• Backend: Python executable built by PyInstaller (handigo_app/backend_server/dist/server/server.exe)

Prerequisites

• Windows 10/11
• Python 3.11 (py -3.11)
• Node.js + npm
• Rust toolchain

Development Run

From the repo root:

cd handigo_app
npm install
npm --prefix frontend_client/Handigo install

Build backend executable (required for tauri dev):

npm run build:backend

Run the app in development mode:

npm run dev

Notes:

• npm run dev starts Tauri and the frontend dev server.
• You do not need to launch the backend separately.
• If backend Python code changes, rebuild it with npm run build:backend before restarting dev mode.

Deployment Build (MSI)

From handigo_app:

npm install
npm --prefix frontend_client/Handigo install
npm run build:backend
npm run build:app

MSI output:

handigo_app/src-tauri/target/release/bundle/msi/HandiGo_0.1.0_x64_en-US.msi

Full Build Shortcut

From handigo_app:

npm run build:all

This builds:

• Python backend executable
• Tauri installer bundle

Troubleshooting

1. Port 3000 already in use:

   taskkill /F /T /IM server.exe

2. Missing Python modules at runtime:
   • Reinstall backend deps in handigo_app:

     py -3.11 -m pip install -r requirements.txt

   • Then rebuild backend:

     npm run build:backend