# Build sur Windows — Dépannage

Le client utilise **Vite**, qui s’appuie sur **esbuild** (binaire natif fourni pour Windows : `@esbuild/win32-x64/esbuild.exe`). Aucune compilation C++ n’est nécessaire : ce sont des exécutables précompilés.

## Vous avez désinstallé « Windows Development » / « Windows Developer » (~2 Go)

Le logiciel d’environ **2 Go** dont le nom contient **Windows Development** ou **Windows Developer** est en général :

- **Visual Studio Build Tools** (outils de génération Visual Studio), ou  
- **Windows SDK** (Software Development Kit), ou  
- un composant **« Développement Windows »** de Visual Studio.

Pour ce projet (Vite + esbuild), **vous n’avez pas besoin de réinstaller tout ça**. Il suffit d’installer le **runtime** qui va avec, beaucoup plus léger.

### 1. Réinstaller uniquement le Visual C++ Redistributable (souvent suffisant)

Après la désinstallation du gros paquet « Windows Development », il peut manquer le **Visual C++ Redistributable** (quelques dizaines de Mo). C’est lui qui permet d’exécuter des .exe natifs comme `esbuild.exe`.

- Télécharger : [Microsoft Visual C++ Redistributable (dernière version)](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)  
- Installer la version **x64** (et éventuellement x86 si vous utilisez du 32 bits).  
- Redémarrer le terminal, puis dans `client/` : `npm run build`.

Pas besoin de réinstaller les 2 Go de « Windows Development » pour faire tourner le build.

### 2. Réinstaller les dépendances du client

```powershell
cd client
Remove-Item -Recurse -Force node_modules
Remove-Item -Force package-lock.json
npm install
npm run build
```

### 3. Antivirus / Windows Defender

Parfois l’antivirus ou Windows Defender bloque l’exécution de `esbuild.exe`.

- Ajouter une exclusion pour le dossier du projet (ou au minimum `client\node_modules`) dans Windows Defender / antivirus.
- Relancer `npm run build`.

### 4. Droits / exécution

- Lancer **PowerShell ou CMD en tant qu’administrateur** une fois, aller dans `client/` et lancer `npm run build` pour vérifier si le problème vient des droits.
- Vérifier que le disque n’est pas en lecture seule et que le dossier n’est pas synchronisé par OneDrive/Dropbox au moment du build.

### 5. Node et npm à jour

```powershell
node -v   # 18+ recommandé
npm -v
```

Si besoin, réinstaller Node depuis [nodejs.org](https://nodejs.org/) (version LTS).

---

En résumé : après avoir désinstallé des outils de dev Windows, réinstaller le **Visual C++ Redistributable** et refaire un `npm install` dans `client/` règle souvent le problème.