# Repository Instructions

## MSIX publish after user approval

When the user says a completed change is approved and asks to publish, deploy,
patch, or update the MSIX, use the automated NAS publish script instead of
manually editing package versions or copying files.

Normal approved publish command:

```powershell
powershell -ExecutionPolicy Bypass -File .\tools\msix\Publish-MsixToNas.ps1 -Configuration Release -IncrementPackageRevision
```

Prerequisites:

- `NAS_USER` must be set to the NAS account with write access to `/volume1/web/msix`.
- `NAS_SSH_KEY` should point to the SSH private key for that NAS account.
- The signing certificate thumbprint must remain
  `E691A33C64DF20A204FFD4F096B9C3EB4B95709C`.

The script will:

1. Read `Tornado3_2026Election/Package.appxmanifest`.
2. Increment the fourth package version part.
3. Build and sign the MSIX package.
4. Rewrite App Installer URLs to the public NAS path.
5. Upload the files to the NAS over SSH/SCP.
6. Verify the public URLs after upload.

Do not run this publish command unless the user has explicitly approved
publishing or deployment.
