Files
TimeTracker/BUILD_QUICK_FIX.md
Dries Peeters 3c433e2593 Add comprehensive documentation for build process and branding
- Add build troubleshooting and Windows-specific guides
- Document branding guidelines and asset management
- Add desktop build configuration documentation
- Include symlink and OneDrive fix guides
- Add code signing and permissions documentation
- Document quick start guides for various scenarios
2026-01-11 20:51:32 +01:00

1.2 KiB

Quick Fix for Windows Build Issues

Try the Simplified Build Script

If build-desktop.bat stops working, use the simplified version:

scripts\build-desktop-simple.bat

This version:

  • Uses simpler logic (no delayed expansion issues)
  • Has better debug output
  • More reliable on Windows

If That Doesn't Work

Step 1: Manual Build

cd desktop
npm install
npx electron-builder --win

Step 2: Check What's Missing

Run the test script:

scripts\test-build-desktop.bat

This will show exactly what's wrong.

Step 3: Common Fixes

  1. Exclude node_modules from OneDrive

    • Right-click desktop\node_modules
    • Choose "Always keep on this device"
  2. Reinstall Dependencies

    cd desktop
    rmdir /s /q node_modules
    del package-lock.json
    npm install
    
  3. Fix Script Issues

    scripts\fix-windows-build.bat
    

Debugging

If the script stops after "npm version", check:

  • Is node_modules missing or corrupted?
  • Are there OneDrive file locks?
  • Does npx work? Try: npx --version

Last Resort: Use the PowerShell script:

.\scripts\build-desktop-windows.ps1