Fix resource paths to use relative ./ instead of absolute / (#260)

Copilot · web-flow · commit df6f2e661237 · 2026-04-02T09:40:33.000+08:00
diff --git a/.env.example b/.env.example
@@ -5,7 +5,7 @@ CROWDIN_PERSONAL_TOKEN="your_personal_token"
 CROWDIN_PROJECT_ID="your_project_id"
 
 # Base path for deployment (e.g., /mini-qr for deploying at domain.com/mini-qr)
-# Default: /
+# Default: ./ (relative paths, works at any sub-path without configuration)
 BASE_PATH=/mini-qr
 
 VITE_HIDE_CREDITS=false
diff --git a/.gitignore b/.gitignore
@@ -33,4 +33,5 @@ dev-dist
 
 # Playwright
 test-results/
-playwright-report/
+playwright-report/
+package-lock.json
diff --git a/index.html b/index.html
@@ -3,8 +3,8 @@
 
 <head>
   <meta charset="UTF-8" />
-  <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-  <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+  <link rel="icon" type="image/svg+xml" href="./favicon.svg" />
+  <link rel="apple-touch-icon" href="./apple-touch-icon.png">
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta http-equiv="X-UA-Compatible" content="ie=edge">
diff --git a/src/utils/basePath.ts b/src/utils/basePath.ts
@@ -7,8 +7,8 @@
  */
 export function getBasePath(): string {
   // Vite makes BASE_PATH available at build time through import.meta.env
-  // If BASE_PATH is not set, default to '/'
-  return import.meta.env.BASE_PATH || '/'
+  // If BASE_PATH is not set, default to './' for relative paths
+  return import.meta.env.BASE_PATH || './'
 }
 
 /**
diff --git a/vite.config.js b/vite.config.js
@@ -7,10 +7,11 @@ import { VitePWA } from 'vite-plugin-pwa'
 export default defineConfig(({ mode }) => {
   // Load environment variables
   const env = loadEnv(mode, '.', '')
-  // Get BASE_PATH from environment variable, default to '/'
+  // Get BASE_PATH from environment variable, default to './' for relative paths
+  // Using './' ensures the app works when deployed at any sub-path without configuration
   // Ensure base path ends with slash for proper URL construction
-  let base = env.BASE_PATH || '/'
-  if (base !== '/' && !base.endsWith('/')) {
+  let base = env.BASE_PATH || './'
+  if (!base.endsWith('/')) {
     base = base + '/'
   }
 
