mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-05-24 15:20:52 -05:00

Files

T

Dries Peeters 5fb49ad375 chore: move documentation and assets to docs/

- Move API, ARCHITECTURE, BUILD, DEVELOPMENT, and fix docs to docs/
- Move README variants and WINDOWS_BUILD to docs/
- Move assets and screenshots to docs/assets/
- Update GETTING_STARTED, README, CONTRIBUTOR_GUIDE, PROJECT_STRUCTURE,
  LOCAL_TESTING_WITH_SQLITE, VERSION_MANAGEMENT

2026-03-15 10:15:51 +01:00

1.8 KiB

Raw 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 Blame History