From dba290e03eb146fc191ffdccc5f1dc6f650044c0 Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 17:00:20 +1200
Subject: [PATCH 1/7] New version.

---
 package.json              | 2 +-
 src/renderer/package.json | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package.json b/package.json
index 36408941b..63c9a8997 100644
--- a/package.json
+++ b/package.json
@@ -23,7 +23,7 @@
     "url": "git+https://github.com/opencor/webapp.git"
   },
   "type": "module",
-  "version": "1.20260924.0",
+  "version": "1.20260924.1",
   "engines": {
     "bun": ">=1.2.0"
   },
diff --git a/src/renderer/package.json b/src/renderer/package.json
index 9f798a9ce..0fc720b48 100644
--- a/src/renderer/package.json
+++ b/src/renderer/package.json
@@ -42,7 +42,7 @@
     },
     "./style.css": "./dist/opencor.css"
   },
-  "version": "1.20260924.0",
+  "version": "1.20260924.1",
   "libopencorVersion": "1.20260803.0",
   "scripts": {
     "build": "vite build && bun scripts/generate.version.ts",

From c3a47e6ee1a9b1ec6cf3ea8ae23a4d96c34dc2e6 Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 16:59:36 +1200
Subject: [PATCH 2/7] Some minor cleaning up.

---
 src/renderer/src/components/dialogs/UpdateAvailableDialog.vue | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
index 7004956b1..dd86d83a6 100644
--- a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
+++ b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
@@ -20,7 +20,6 @@
 </template>
 
 <script setup lang="ts">
-import * as common from '../../common/common';
 import { latestVersion } from '../../common/version';
 
 defineEmits<{

From 4a0a0cac90f3b74df7887d16f9c94440101bf769 Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 16:56:06 +1200
Subject: [PATCH 3/7] Programmatically force reload OpenCOR when a new version
 is available.

---
 src/renderer/src/common/version.ts              | 17 ++++++++++++++++-
 .../dialogs/UpdateAvailableDialog.vue           | 15 +++++++++------
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/src/renderer/src/common/version.ts b/src/renderer/src/common/version.ts
index b1ce1f8eb..dbe443791 100644
--- a/src/renderer/src/common/version.ts
+++ b/src/renderer/src/common/version.ts
@@ -95,6 +95,21 @@ const startCheck = (): void => {
   }
 };
 
+// Force reload the Web app.
+
+const forceReload = async (): Promise<void> => {
+  // Note: there is no standard way to force reload a page (location.reload(true) is non-standard and ignored by modern
+  //       browsers). So, we first fetch the page with cache: 'reload', which bypasses the HTTP cache and updates it
+  //       with the latest version of the page, and then reload the page.
+
+  try {
+    await fetch(window.location.href, { cache: 'reload' });
+  } catch (_error: unknown) {
+  }
+
+  window.location.reload();
+};
+
 // Export the version checking functions and state.
 
-export { currentVersion, latestVersion, startCheck, updateAvailable };
+export { currentVersion, forceReload, latestVersion, startCheck, updateAvailable };
diff --git a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
index dd86d83a6..cb08a2b0a 100644
--- a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
+++ b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
@@ -6,25 +6,28 @@
       </div>
       <div class="space-y-2">
         <div class="text-center">
-          <span class="text-lg">Feel free to <strong>force reload</strong> OpenCOR whenever you are ready.</span><br />
-          <em>(You can force reload by pressing
-          <span v-if="common.isMacOs()" class="highlight">⇧⌘R</span>
-          <span v-else><span class="highlight">Ctrl</span>+<span class="highlight">Shift</span>+<span class="highlight">R</span></span>.)</em>
+          <span class="text-lg">Feel free to reload OpenCOR whenever you are ready.</span><br />
+          <em>(Please note that any unsaved work will be lost.)</em>
         </div>
       </div>
     </div>
     <template #footer>
-      <Button label="OK" autofocus @click="$emit('close')" />
+      <Button label="Reload" autofocus @click="onReloadNow" />
+      <Button label="Cancel" severity="secondary" @click="$emit('close')" />
     </template>
   </BaseDialog>
 </template>
 
 <script setup lang="ts">
-import { latestVersion } from '../../common/version';
+import { forceReload, latestVersion } from '../../common/version';
 
 defineEmits<{
   close: [];
 }>();
+
+const onReloadNow = (): void => {
+  void forceReload();
+};
 </script>
 
 <style scoped>

From 91e0f1ea49946a103895e39a5bf4eed5b3631fbe Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 17:07:06 +1200
Subject: [PATCH 4/7] Formatting.

---
 src/renderer/src/common/version.ts | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/renderer/src/common/version.ts b/src/renderer/src/common/version.ts
index dbe443791..769efe514 100644
--- a/src/renderer/src/common/version.ts
+++ b/src/renderer/src/common/version.ts
@@ -104,8 +104,7 @@ const forceReload = async (): Promise<void> => {
 
   try {
     await fetch(window.location.href, { cache: 'reload' });
-  } catch (_error: unknown) {
-  }
+  } catch (_error: unknown) {}
 
   window.location.reload();
 };

From a9d8b5e2bcf5eeeaabe44467078cebc79c1ac6dc Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 17:25:07 +1200
Subject: [PATCH 5/7] Refresh every file OpenCOR's Web app uses, not just its
 main page.

---
 src/renderer/scripts/generate.version.ts | 22 ++++++++--
 src/renderer/src/common/version.ts       | 55 +++++++++++++++++++++---
 2 files changed, 69 insertions(+), 8 deletions(-)

diff --git a/src/renderer/scripts/generate.version.ts b/src/renderer/scripts/generate.version.ts
index 567a7db20..24a407388 100644
--- a/src/renderer/scripts/generate.version.ts
+++ b/src/renderer/scripts/generate.version.ts
@@ -12,16 +12,32 @@ const version = (JSON.parse(fs.readFileSync(packageJsonPath)) as { version: stri
 
 // Make sure that the dist/assets folder exists.
 
-const distAssetsPath = path.join(__dirname, '../dist/assets');
+const distPath = path.join(__dirname, '../dist');
+const distAssetsPath = path.join(distPath, 'assets');
 
 if (!fs.existsSync(distAssetsPath)) {
   fs.mkdirSync(distAssetsPath, { recursive: true });
 }
 
+// List the files that the Web app needs to refresh when force reloading it.
+// Note: we exclude index.html (the Web app refreshes the page itself using its actual URL), version.json (it is always
+//       fetched with cache busting), stats.html (it is not part of the Web app), and libOpenCOR's files (their path
+//       contains libOpenCOR's version, so they never get stale).
+
+const files = (fs.readdirSync(distPath, { recursive: true }) as string[])
+  .map((file) => file.split(path.sep).join('/'))
+  .filter(
+    (file) =>
+      fs.statSync(path.join(distPath, file)).isFile() &&
+      !['index.html', 'assets/version.json', 'stats.html'].includes(file) &&
+      !file.startsWith('libopencor/')
+  )
+  .sort();
+
 // Write the version file.
 
-fs.writeFileSync(path.join(distAssetsPath, 'version.json'), JSON.stringify({ version }, null, 2));
+fs.writeFileSync(path.join(distAssetsPath, 'version.json'), JSON.stringify({ version, files }, null, 2));
 
 // Log the generated version.
 
-console.log(`Generated version.json with version ${version}.`);
+console.log(`Generated version.json with version ${version} and ${files.length} files.`);
diff --git a/src/renderer/src/common/version.ts b/src/renderer/src/common/version.ts
index 769efe514..dbd7e9b87 100644
--- a/src/renderer/src/common/version.ts
+++ b/src/renderer/src/common/version.ts
@@ -13,6 +13,7 @@ const latestVersion = vue.ref<string>('');
 
 interface IVersionInfo {
   version: string;
+  files?: string[];
 }
 
 const checkForUpdates = async (): Promise<boolean> => {
@@ -96,15 +97,59 @@ const startCheck = (): void => {
 };
 
 // Force reload the Web app.
+// Note: there is no standard way to force reload a page (location.reload(true) is non-standard and ignored by modern
+//       browsers). Also, our assets don't have a hash in their filenames (see vite.config.ts), so they may be stale in
+//       the HTTP cache too. So, we first fetch the page and all the files listed in the latest version.json file with
+//       cache: 'reload', which bypasses the HTTP cache and updates it, and then we reload the page. We do this within a
+//       given amount of time after which we reload the page anyway, so that the user is never left waiting forever.
+
+const FORCE_RELOAD_TIMEOUT = 30 * 1000; // 30 seconds.
+
+let forceReloading = false;
 
 const forceReload = async (): Promise<void> => {
-  // Note: there is no standard way to force reload a page (location.reload(true) is non-standard and ignored by modern
-  //       browsers). So, we first fetch the page with cache: 'reload', which bypasses the HTTP cache and updates it
-  //       with the latest version of the page, and then reload the page.
+  if (forceReloading) {
+    return;
+  }
+
+  forceReloading = true;
+
+  // Create an AbortController to abort the fetch requests if they take too long.
+
+  const abortController = new AbortController();
+  const timeoutId = window.setTimeout(() => {
+    abortController.abort();
+  }, FORCE_RELOAD_TIMEOUT);
+
+  // Refresh the given URL in the HTTP cache.
+  // Note: we need to read the body since the HTTP cache is only updated once the body has been fully received.
+
+  const refresh = async (url: string): Promise<void> => {
+    const response = await fetch(url, { cache: 'reload', signal: abortController.signal });
+
+    await response.blob();
+  };
 
   try {
-    await fetch(window.location.href, { cache: 'reload' });
-  } catch (_error: unknown) {}
+    // Retrieve the list of files used by the latest version of OpenCOR's Web app.
+
+    const response = await fetch(`./assets/version.json?t=${Date.now()}`, {
+      cache: 'no-store',
+      signal: abortController.signal
+    });
+    const versionInfo: IVersionInfo = response.ok ? await response.json() : { version: '' };
+
+    // Refresh the page and all the files.
+
+    await Promise.allSettled([
+      refresh(window.location.href),
+      ...(versionInfo.files ?? []).map((file) => refresh(new URL(file, document.baseURI).href))
+    ]);
+  } catch (_error: unknown) {
+    // Ignore any error (including a timeout) and reload the page anyway.
+  } finally {
+    window.clearTimeout(timeoutId);
+  }
 
   window.location.reload();
 };

From 472616adb24b2c4807887f16045b92d1ad48b285 Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 17:55:47 +1200
Subject: [PATCH 6/7] Upload version.json last in CD workflows.

---
 .github/workflows/cd.yml    | 4 ++++
 .github/workflows/cddev.yml | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.yml
index f0f885393..f053231ec 100644
--- a/.github/workflows/cd.yml
+++ b/.github/workflows/cd.yml
@@ -123,6 +123,10 @@ jobs:
           local-path: ./src/renderer/dist
           remote-path: /home/www/opencor.ws/app
           sync: full
+          # Note: we upload version.json last so that OpenCOR's Web app only reports a new version once all the other
+          #       files have been uploaded.
+          ftp-mirror-options: --exclude-glob=assets/version.json
+          ftp-post-sync-commands: put -O /home/www/opencor.ws/app/assets ./src/renderer/dist/assets/version.json
       - name: Archive OpenCOR's Web app
         run: bun archive:web
       - name: Release OpenCOR's Web app
diff --git a/.github/workflows/cddev.yml b/.github/workflows/cddev.yml
index bba30d211..140556155 100644
--- a/.github/workflows/cddev.yml
+++ b/.github/workflows/cddev.yml
@@ -38,3 +38,7 @@ jobs:
           local-path: ./src/renderer/dist
           remote-path: /home/www/opencor.ws/appdev
           sync: full
+          # Note: we upload version.json last so that OpenCOR's Web app only reports a new version once all the other
+          #       files have been uploaded.
+          ftp-mirror-options: --exclude-glob=assets/version.json
+          ftp-post-sync-commands: put -O /home/www/opencor.ws/appdev/assets ./src/renderer/dist/assets/version.json

From 8e5832636e2d8d6effd6880bef7ac3637920aae1 Mon Sep 17 00:00:00 2001
From: Alan Garny <agarny@hellix.com>
Date: Thu, 24 Sep 2026 18:04:35 +1200
Subject: [PATCH 7/7] Disable the update dialog close during reload.

---
 .../dialogs/UpdateAvailableDialog.vue           | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
index cb08a2b0a..7fcd11076 100644
--- a/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
+++ b/src/renderer/src/components/dialogs/UpdateAvailableDialog.vue
@@ -1,5 +1,8 @@
 <template>
-  <BaseDialog header=" " class="w-169">
+  <BaseDialog header=" " class="w-169"
+    :closeButtonProps="{ severity: 'secondary', text: true, rounded: true, disabled: reloading }"
+    :closeOnEscape="!reloading"
+  >
     <div class="space-y-7">
       <div class="text-center">
         <div class="text-3xl font-bold">OpenCOR <span class="highlight highlight-version">{{ latestVersion }}</span> is available!</div>
@@ -7,25 +10,31 @@
       <div class="space-y-2">
         <div class="text-center">
           <span class="text-lg">Feel free to reload OpenCOR whenever you are ready.</span><br />
-          <em>(Please note that any unsaved work will be lost.)</em>
+          <em >(Please note that any unsaved work will be lost.)</em>
         </div>
       </div>
     </div>
     <template #footer>
-      <Button label="Reload" autofocus @click="onReloadNow" />
-      <Button label="Cancel" severity="secondary" @click="$emit('close')" />
+      <Button :label="reloading?'Reloading...':'Reload'" autofocus :loading="reloading" @click="onReloadNow" />
+      <Button label="Cancel" severity="secondary" :disabled="reloading" @click="$emit('close')" />
     </template>
   </BaseDialog>
 </template>
 
 <script setup lang="ts">
+import * as vue from 'vue';
+
 import { forceReload, latestVersion } from '../../common/version';
 
 defineEmits<{
   close: [];
 }>();
 
+const reloading = vue.ref(false);
+
 const onReloadNow = (): void => {
+  reloading.value = true;
+
   void forceReload();
 };
 </script>