diff --git a/.gitea/workflows/node-check.yml b/.gitea/workflows/node-check.yml
index 3a328d6..9094b7e 100644
--- a/.gitea/workflows/node-check.yml
+++ b/.gitea/workflows/node-check.yml
@@ -23,6 +23,11 @@ on:
     secrets:
       KUMA_PUSH_TOKEN:
         required: true
+      BUILD_ENV:
+        # Optional: dotenv-Text, wird vor dem Check nach .env geschrieben. Für Projekte, deren
+        # Tests oder Build Umgebungsvariablen brauchen (z. B. VITE_*). Gehört ins Repo-Secret,
+        # nicht ins Repository — auch wenn die Werte im Client-Bundle ohnehin sichtbar sind.
+        required: false
 
 jobs:
   pruefen:
@@ -39,6 +44,13 @@ jobs:
           node-version: ${{ inputs.node-version }}
           cache: npm
 
+      - name: Build-Umgebung schreiben (falls Secret gesetzt)
+        run: |
+          if [ -n "${{ secrets.BUILD_ENV }}" ]; then
+            printf '%s\n' "${{ secrets.BUILD_ENV }}" > .env
+            echo "$(grep -c '=' .env) Variablen aus BUILD_ENV nach .env geschrieben"
+          fi
+
       - run: npm ci
 
       - name: Check (wie lokal)