This folder contains the Electron wrapper for Task Matrix desktop apps.

Electron provides a cross-platform desktop environment (Chromium + Node.js) that loads the HTML app. This single codebase can build for Windows, Linux, and macOS.

TaskMatrix-Desktop\
├── main.js                     # Electron window manager
├── package.json                # Dependencies & build config
├── index.html                  # Core app (synced from TaskMatrix\)
├── node_modules\               # Installed packages
└── dist\                       # Built executables (after build)
    ├── Task Matrix 3.0.0.exe   # Portable version
    └── Task Matrix Setup 3.0.0.exe  # Installer

# Install dependencies (first time only)
npm install

# Run in dev mode
npm start

Automated build (from TaskMatrix folder):

cd ..\TaskMatrix
.\build-desktop.ps1

Manual build:

# Sync latest HTML
Copy-Item "..\TaskMatrix\index.html" -Destination "index.html" -Force

# Build Windows executable
npm run build:win

• name: "task-matrix"
• version: "3.0.0"
• main: "main.js"
• electron: 39.1.0
• electron-builder: 26.0.12

"build": {
  "appId": "com.taskmatrix.app",
  "productName": "Task Matrix",
  "win": {
    "target": ["nsis", "portable"],
    "icon": "assets/icon.ico"
  }
}

• Output:
  • Task Matrix 3.0.0.exe (portable, no install)
  • Task Matrix Setup 3.0.0.exe (installer with shortcuts)
• Size: ~95 MB each
• Distribution: Share files directly

Update package.json:

"linux": {
  "target": ["AppImage", "deb"],
  "category": "Utility"
}

Build: npm run build:linux (requires Linux or WSL)

Update package.json:

"mac": {
  "target": ["dmg", "zip"],
  "category": "public.app-category.productivity"
}

Build: npm run build:mac (requires macOS)

IMPORTANT: Always sync the latest HTML before building!

Copy-Item "..\TaskMatrix\index.html" -Destination "index.html" -Force

Or use the automated script: TaskMatrix\build-desktop.ps1

DO NOT edit index.html in this folder directly!

Edit E:\APPS\TaskMatrix\index.html instead, then sync.

Run: npm install

• Signing is disabled in package.json
• If error persists, check file permissions

Run: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Install Node.js from https://nodejs.org

• Main README: E:\APPS\TaskMatrix\README.md
• Architecture: E:\APPS\TaskMatrix\ARCHITECTURE.md
• Build Script: E:\APPS\TaskMatrix\build-desktop.ps1

• Electron Documentation: https://www.electronjs.org/docs
• electron-builder: https://www.electron.build
• Node.js: https://nodejs.org

Version: 3.0.0
Framework: Electron
Target Platforms: Windows ✅ | Linux 🔜 | macOS 🔜