From 314f339ba9a1cb576fd8f590b07e43a2c82572dc Mon Sep 17 00:00:00 2001 From: cproudlock Date: Fri, 17 Jul 2026 18:58:06 -0400 Subject: [PATCH] Dev setup: winget install commands for the Windows toolchain Add a winget block to the prerequisites (Git/Python/Node/VS Code/MySQL or Docker) so a Windows dev provisions the whole toolchain from one terminal, with a note that the LTS Node may be newer than CI's 20 and it does not matter for this SPA (nvm-windows to pin if wanted). --- docs/DEVELOPMENT-SETUP.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/DEVELOPMENT-SETUP.md b/docs/DEVELOPMENT-SETUP.md index 2551c67..7148040 100644 --- a/docs/DEVELOPMENT-SETUP.md +++ b/docs/DEVELOPMENT-SETUP.md @@ -28,6 +28,21 @@ sane, then use manual for day-to-day work. | MySQL | 8.0 (or Docker, below) | `mysql --version` | | Git | any recent | `git --version` | +On Windows, install all of them with winget (accept each license, then +reopen the terminal so PATH updates): + +```powershell +winget install Git.Git # includes Git Bash (naming hook needs it) +winget install Python.Python.3.12 +winget install OpenJS.NodeJS.LTS # LTS; may install v24, fine for this SPA +winget install Microsoft.VisualStudioCode +winget install Oracle.MySQL # or Docker.DockerDesktop for the DB +``` + +CI runs Node 20; the LTS package may be newer. This Vite/Vue frontend builds +identically across 20-24, so it does not matter. To pin exactly: +`winget install CoreyButler.NVMforWindows` then `nvm install 20; nvm use 20`. + --- ## 1. Get the code