heros_web/docs/deployment.md

Deployment

The NAS deployment should leave one canonical web directory:

• /volume1/web/heros_web

Use the checked-in script instead of ad-hoc deploy commands:

pnpm deploy:nas

By default, scripts/deploy-nas.ps1 builds the project, uploads dist, swaps the remote directory, and removes transient deploy or backup folders. This keeps /volume1/web from filling with heros_web.backup-* and .heros_web_deploy_* directories.

Optional backup retention:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/deploy-nas.ps1 -Build -BackupRetention 3

Use nonzero retention only for a temporary release window. The normal project default is 0, so only /volume1/web/heros_web remains after deployment.