diff --git a/.gitea/workflows/test.yml b/.gitea/workflows/test.yml
index 1903de8..872f18b 100644
--- a/.gitea/workflows/test.yml
+++ b/.gitea/workflows/test.yml
@@ -29,4 +29,11 @@ jobs:
         run: pnpm test:backend
 
       - name: Frontend tests (Vitest)
+        # Supabase's createClient validates the URL at module load, so the
+        # frontend tests need *some* value to import lib/supabase without
+        # throwing. Real auth calls are stubbed in the tests, so these are
+        # purely structural placeholders — never used over the wire.
+        env:
+          VITE_SUPABASE_URL: http://localhost:54321
+          VITE_SUPABASE_ANON_KEY: placeholder-anon-key-for-tests-only
         run: pnpm test:frontend