🚀 Migrate to SPA system

.docker/nginx.conf

@@ -5,8 +5,17 @@ server {
   root /usr/share/nginx/html;
   server_tokens off;
 
+  # Standard static-file performance knobs.
+  sendfile          on;
+  tcp_nopush        on;
+  tcp_nodelay       on;
+  keepalive_timeout 65;
+
+  access_log off;
+
   # Compression for text-y assets — icons (PNG) are excluded.
   gzip on;
+  gzip_vary on;
   gzip_min_length 1024;
   gzip_types
     text/plain
@@ -16,6 +25,14 @@ server {
     application/xml
     image/svg+xml;
 
+  # Vite code-split chunks carry a content hash in their filename (chunks/[name]-[hash].js).
+  # They are truly immutable — cache forever.  ^~ skips regex matching for this prefix.
+  location ^~ /chunks/ {
+    add_header Cache-Control "public, max-age=31536000, immutable" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    try_files $uri =404;
+  }
+
   # Entry points: HTML pages + the manifest XML are mutable URLs.
   # No caching — Outlook always pulls a fresh copy when reopening the add-in.
   location ~ \.(html|xml)$ {
@@ -33,20 +50,16 @@ server {
     try_files $uri =404;
   }
 
-  # JS / CSS — moderate cache, ETag-based revalidation.
-  # Filenames are not content-hashed (manifest references stable names) so we keep TTL short.
+  # Entry JS + CSS — stable (unhashed) filenames, short cache with ETag revalidation.
   location ~ \.(js|css)$ {
     add_header Cache-Control "public, max-age=300, must-revalidate" always;
     add_header X-Content-Type-Options "nosniff" always;
     try_files $uri =404;
   }
 
-  # Bare-domain hits redirect to the marketing site. The add-in itself is loaded by Outlook
-  # at /taskpane.html (and its sibling assets), so this only affects users typing the
-  # asset host directly into a browser. LANDING_URL is resolved at container start
-  # by .docker/40-substitute-base-url.sh.
   location = / {
-    return 302 __LANDING_URL__;
+    absolute_redirect off;
+    return 302 /taskpane.html;
   }
 
   # Catch-all: serve as static, otherwise 404.

.github/workflows/_ci.yml

@@ -5,19 +5,16 @@ on:
 
 jobs:
   ci:
-    name: Build & Type-check (Node ${{ matrix.node }})
+    name: Build & Type-check
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node: ['18', '20', '22']
 
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Node.js ${{ matrix.node }}
+      - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: ${{ matrix.node }}
+          node-version: '24'
           cache: 'npm'
 
       - name: Install dependencies
@@ -34,6 +31,5 @@ jobs:
         continue-on-error: true
 
       - name: Validate manifest
-        # Pin to 1.x: 2.x requires Node 20+ (ESM strip-bom), and we still test Node 18.
-        run: npx --yes -p office-addin-manifest@1.13.6 office-addin-manifest validate manifest.xml
+        run: npx --yes -p office-addin-manifest@latest office-addin-manifest validate manifest.xml
         continue-on-error: true

.github/workflows/main.yml

@@ -5,19 +5,20 @@ on:
     branches: ['**']
     paths: &code_paths
       - 'src/**'
-      - 'assets/**'
+      - 'public/**'
+      - 'taskpane.html'
       - 'manifest.xml'
       - 'package.json'
       - 'package-lock.json'
       - 'tsconfig.json'
-      - 'webpack.config.js'
+      - 'tsconfig.node.json'
+      - 'vite.config.mts'
       - 'eslint.config.mjs'
-      - 'nginx.conf'
+      - '.nvmrc'
       - 'Dockerfile'
       - '.dockerignore'
-      - '.github/workflows/main.yml'
-      - '.github/workflows/_ci.yml'
-      - '.github/workflows/_docker.yml'
+      - '.docker/**'
+      - '.github/workflows/**'
   pull_request:
     paths: *code_paths
 

.github/workflows/release.yml

@@ -43,7 +43,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '24'
           cache: 'npm'
 
       - name: Install dependencies
@@ -71,8 +71,7 @@ jobs:
         run: npm run build
 
       - name: Validate manifest
-        # Pin to 1.x: 2.x requires Node 20+ (ESM strip-bom). Local dev runs on Node 18.
-        run: npx --yes -p office-addin-manifest@1.13.6 office-addin-manifest validate manifest.xml
+        run: npx --yes -p office-addin-manifest@latest office-addin-manifest validate manifest.xml
 
       - name: Create release archive
         run: |

.gitignore

@@ -4,3 +4,5 @@
 /.idea
 /.certs
 /manifest.*.xml
+/auto-imports.d.ts
+/components.d.ts

.nvmrc

@@ -0,0 +1 @@
+24