mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-01-31 17:09:40 -06:00

Files

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.8 KiB

Raw Permalink Blame History

Fix Symbolic Link Permission Error

Quick Fix

The error is caused by Windows not having permission to create symbolic links.

Option 1: Enable Developer Mode (Recommended - One Time)

Press Win + I to open Settings
Go to Privacy & Security → For developers
Turn on Developer Mode
Restart your terminal/PowerShell
Try building again

This is a one-time setting and allows creating symlinks without administrator privileges.

Option 2: Run as Administrator

Right-click PowerShell or Command Prompt
Choose "Run as Administrator"

Navigate to project and build:

cd C:\Users\dries\OneDrive\Dokumente\GitHub\TimeTracker
scripts\build-desktop-simple.bat

Option 3: Clear Cache and Rebuild

The build configuration has been updated to disable code signing (which avoids the symlink issue):

Clear electron-builder cache:

scripts\clear-electron-builder-cache.bat

Build again:
```
scripts\build-desktop-simple.bat
```

What Was Fixed

Removed deprecated compressor option from NSIS config
Disabled code signing (forceCodeSigning: false) to avoid symlink issues
Build script now clears winCodeSign cache before building
Added helper script to clear cache manually

Why This Happens

electron-builder downloads code signing tools (winCodeSign) which contain macOS files using symbolic links. Windows needs special permissions to create symlinks.

Solution Applied

The desktop/package.json now has:

"win": {
  "forceCodeSigning": false
}

This prevents electron-builder from downloading the code signing tools that cause symlink issues.

Best Solution: Enable Developer Mode (one-time setup) + the build config is already fixed!

1.8 KiB Raw Permalink Blame History