createDocument: permissions [] explizit übergeben (403-Versuch)

Entfernen: Debug-Instrumentierung (localhost:7243) aus Contact und Appwrite
Fix: json-bigint stringify nutzt _isBigNumber (behebt e.isBigNumber in prepareRequest)
2026-02-07 09:42:57 +00:00 · 2026-02-07 09:17:47 +00:00 · 2026-02-07 09:07:20 +00:00 · 2026-02-07 08:58:34 +00:00 · 2026-02-07 08:58:09 +00:00 · 2026-02-07 08:47:48 +00:00
38 changed files with 6378 additions and 28 deletions
--- a/.env.example
+++ b/.env.example
@@ -0,0 +1,11 @@
+# Appwrite – Kopie auf dem Server als .env anlegen (wird nicht mit Git gepusht!)
+# Nach dem Klonen/Pullen: npm run setup:env oder cp .env.example .env
+
+VITE_APPWRITE_ENDPOINT=https://appwrite.webklar.com/v1
+VITE_APPWRITE_PROJECT_ID=696b82270034001dab69
+VITE_APPWRITE_DATABASE_ID=698124a20035e8f6dc42
+VITE_APPWRITE_CONTACT_COLLECTION_ID=contact_submissions
+
+# Optional: Supabase (falls später genutzt)
+# VITE_SUPABASE_URL=
+# VITE_SUPABASE_ANON_KEY=
--- a/.gitignore
+++ b/.gitignore
@@ -11,6 +11,7 @@ node_modules
 dist
 dist-ssr
 *.local
+.env

 # Editor directories and files
 .vscode/*
--- a/docs/APPWRITE-CORS.md
+++ b/docs/APPWRITE-CORS.md
@@ -0,0 +1,32 @@
+# Appwrite CORS / Plattformen einrichten
+
+Wenn das Kontaktformular mit **403 (Forbidden)** oder **CORS** fehlschlägt, fehlt deine Origin in Appwrite.
+
+## In der Appwrite Console
+
+1. Öffne **https://appwrite.webklar.com** (oder deine Appwrite-Installation).
+2. Wähle dein **Projekt** (Project ID: `696b82270034001dab69`).
+3. Gehe zu **Settings** (Projekt-Einstellungen).
+4. Unter **Platforms** (Plattformen) siehst du z. B. eine Web-App mit `http://localhost:8080`.
+
+## Erlaubte Origins hinzufügen
+
+Du musst **jede URL**, von der aus die Webseite läuft, als **Plattform** anlegen (oder die bestehende Web-Plattform um weitere Hostnamen erweitern, falls deine Appwrite-Version das unterstützt).
+
+Typischerweise:
+
+| Umgebung | URL (Origin) |
+|----------|----------------|
+| Lokal / Dev | `http://localhost:8080` |
+| Server (IP) | `http://100.84.12.11:8080` |
+| Produktion | `https://webklar.com` (bzw. deine echte Domain) |
+
+### Vorgehen
+
+- **Neue Plattform** → **Web App** anlegen:
+  - **Name:** z. B. „Webklar Produktion“
+  - **Hostname:** `webklar.com` (ohne https://)  
+    Oder für die IP: `100.84.12.11` (und ggf. Port in den Einstellungen, falls nötig).
+- Oder in der **bestehenden** Web-App alle benötigten Hostnames eintragen (je nach Appwrite-Version: mehrere Hostnames oder mehrere Web-Apps).
+
+Nach dem Speichern sind die neuen Origins erlaubt und der CORS-Fehler sollte verschwinden. Seite und Kontaktformular neu laden und testen.
--- a/docs/DEPLOY-SERVER.md
+++ b/docs/DEPLOY-SERVER.md
@@ -0,0 +1,34 @@
+# Deployment auf dem Server
+
+## .env wird nicht mit Git übertragen
+
+Die Datei **`.env`** steht in `.gitignore` und wird beim `git push` **nicht** mit ins Repository übernommen. Auf dem Server fehlen dadurch die Umgebungsvariablen für Appwrite – die Meldung *"Appwrite ist nicht konfiguriert"* entsteht genau deshalb.
+
+## Lösung: .env auf dem Server anlegen
+
+**Im Repo mitgepusht:** `.env.example`, `scripts/setup-env.cjs`, und die Script-Einträge in `package.json` (`setup:env`, `deploy:server`). Die `.env` wird weiterhin **nicht** ins Git aufgenommen.
+
+**Nach dem ersten Klonen oder nach jedem Pullen auf dem Server:**
+
+**Option A – ein Befehl (empfohlen):**  
+Legt `.env` aus `.env.example` an (falls noch nicht vorhanden) und baut die App:
+
+```bash
+npm run deploy:server
+```
+
+**Option B – einzeln:**  
+Nur `.env` anlegen (überschreibt keine bestehende `.env`):
+
+```bash
+npm run setup:env
+npm run build
+```
+
+**Option C – mit deploy.sh / Container:**  
+Wenn auf dem Server ein `deploy.sh` und Docker/Compose genutzt werden: Nach `git pull` kann `deploy.sh` die `.env` aus `.env.example` erzeugen (falls fehlend) und vor jedem Build eine `.env.local` aus den Container-Umgebungsvariablen schreiben (z. B. alle `VITE_APPWRITE_*`). So kommt die Appwrite-Konfiguration zuverlässig ins Frontend-Build. Ein Neustart von Nginx ist in der Regel nicht nötig; der neue Build liegt in `/out` (oder dem konfigurierten Ausgabeordner).
+
+**Option D – manuell:**  
+`.env` selbst anlegen mit dem Inhalt von `.env.example` oder den Werten aus dieser Doku, danach `npm run build`.
+
+**.env nicht committen** – sie bleibt nur lokal bzw. auf dem Server und enthält projektspezifische Werte.
--- a/docs/PROMPT-SERVER-SETUP.md
+++ b/docs/PROMPT-SERVER-SETUP.md
@@ -0,0 +1,36 @@
+# Prompt für KI mit Server-Zugriff (automatisches .env + Build)
+
+Kopiere den folgenden Block und gib ihn einer KI, die Zugriff auf deinen Server hat (z. B. Cursor Agent, SSH-Terminal, Deployment-KI).
+
+---
+
+## Prompt (zum Kopieren)
+
+```
+Kontext: Das Projekt ist eine Vite/React-Webapp (Webklar). Die Datei .env wird aus Sicherheitsgründen nicht mit Git mitgepusht. Auf dem Server fehlt sie deshalb nach git pull – dadurch erscheint die Meldung "Appwrite ist nicht konfiguriert".
+
+Aufgabe:
+1. In das Projektverzeichnis der Webklar-App wechseln (dort wo package.json und .env.example liegen).
+2. .env aus der Vorlage anlegen, falls sie noch nicht existiert:
+   - Befehl ausführen: npm run setup:env
+   - (Das Skript kopiert .env.example nach .env und überschreibt keine bestehende .env.)
+3. Die App neu bauen, damit die Umgebungsvariablen ins Frontend kommen:
+   - Befehl ausführen: npm run build
+4. Optional: Den Webserver/Prozess neu starten (z. B. PM2, systemd, nginx), der die gebauten Dateien aus dist/ ausliefert oder die App betreibt.
+
+Alternativ kannst du in einem Schritt beides machen: npm run deploy:server (legt .env an, falls fehlend, und führt danach vite build aus).
+
+Wichtig: Im Projektroot ausführen, also dort wo package.json und scripts/setup-env.js liegen.
+```
+
+---
+
+## Kurzversion (nur Befehle)
+
+Wenn die KI schon im richtigen Projektordner ist:
+
+```
+Führe nacheinander aus:
+1. npm run deploy:server
+2. [Webserver/App neu starten, falls nötig – z. B. pm2 restart webklar oder systemctl restart dein-service]
+```
--- a/package-lock.json
+++ b/package-lock.json
@@ -39,6 +39,7 @@
        "@react-three/fiber": "^8.18.0",
        "@tabler/icons-react": "^3.36.1",
        "@tanstack/react-query": "^5.83.0",
+        "appwrite": "^22.0.0",
        "class-variance-authority": "^0.7.1",
        "clsx": "^2.1.1",
        "cmdk": "^1.1.1",
@@ -79,6 +80,7 @@
        "globals": "^15.15.0",
        "jsdom": "^20.0.3",
        "lovable-tagger": "^1.1.13",
+        "patch-package": "^8.0.1",
        "postcss": "^8.5.6",
        "tailwindcss": "^3.4.17",
        "typescript": "^5.8.3",
@@ -137,6 +139,7 @@
      "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@babel/code-frame": "^7.29.0",
        "@babel/generator": "^7.29.0",
@@ -3051,8 +3054,7 @@
      "resolved": "https://registry.npmjs.org/@types/aria-query/-/aria-query-5.0.4.tgz",
      "integrity": "sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==",
      "dev": true,
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
    },
    "node_modules/@types/babel__core": {
      "version": "7.20.5",
@@ -3200,6 +3202,7 @@
      "integrity": "sha512-bJFoMATwIGaxxx8VJPeM8TonI8t579oRvgAuT8zFugJsJZgzqv0Fu8Mhp68iecjzG7cnN3mO2dJQ5uUM2EFrgQ==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "undici-types": "~6.21.0"
      }
@@ -3215,6 +3218,7 @@
      "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.23.tgz",
      "integrity": "sha512-/LDXMQh55EzZQ0uVAZmKKhfENivEvWz6E+EYzh+/MCjMhNsotd+ZHhBGIjFDTi6+fz0OhQQQLbTgdQIxxCsC0w==",
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@types/prop-types": "*",
        "csstype": "^3.0.2"
@@ -3226,6 +3230,7 @@
      "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==",
      "devOptional": true,
      "license": "MIT",
+      "peer": true,
      "peerDependencies": {
        "@types/react": "^18.0.0"
      }
@@ -3291,6 +3296,7 @@
      "integrity": "sha512-Zhy8HCvBUEfBECzIl1PKqF4p11+d0aUJS1GeUiuqK9WmOug8YCmC4h4bjyBvMyAMI9sbRczmrYL5lKg/YMbrcQ==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@typescript-eslint/scope-manager": "8.38.0",
        "@typescript-eslint/types": "8.38.0",
@@ -3639,6 +3645,13 @@
        "url": "https://opencollective.com/vitest"
      }
    },
+    "node_modules/@yarnpkg/lockfile": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@yarnpkg/lockfile/-/lockfile-1.1.0.tgz",
+      "integrity": "sha512-GpSwvyXOcOOlV70vbnzjj4fW5xW/FdUF6nQEt1ENy7m4ZCczi1+/buVUPAqmGfqznsORNFzUMjctTIp8a9tuCQ==",
+      "dev": true,
+      "license": "BSD-2-Clause"
+    },
    "node_modules/abab": {
      "version": "2.0.6",
      "resolved": "https://registry.npmjs.org/abab/-/abab-2.0.6.tgz",
@@ -3653,6 +3666,7 @@
      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "bin": {
        "acorn": "bin/acorn"
      },
@@ -3770,6 +3784,15 @@
        "node": ">= 8"
      }
    },
+    "node_modules/appwrite": {
+      "version": "22.0.0",
+      "resolved": "https://registry.npmjs.org/appwrite/-/appwrite-22.0.0.tgz",
+      "integrity": "sha512-iFlfshYttuQheIyar6m789+Z/gvfKWQxWQCDhHzH9cEkFkn+laJZV8nMvGRH+1rTYNfAcFuycWKBGZiEDFxXug==",
+      "dependencies": {
+        "bignumber.js": "9.0.0",
+        "json-bigint": "1.0.0"
+      }
+    },
    "node_modules/arg": {
      "version": "5.0.2",
      "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
@@ -3886,6 +3909,14 @@
      ],
      "license": "MIT"
    },
+    "node_modules/bignumber.js": {
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.0.0.tgz",
+      "integrity": "sha512-t/OYhhJ2SD+YGBQcjY8GzzDHEk9f3nerxjtfa6tlMXfe7frs/WozhvCNoGvpM0P3bNf3Gq5ZRMlGr5f3r4/N8A==",
+      "engines": {
+        "node": "*"
+      }
+    },
    "node_modules/binary-extensions": {
      "version": "2.3.0",
      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
@@ -3941,6 +3972,7 @@
        }
      ],
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "caniuse-lite": "^1.0.30001726",
        "electron-to-chromium": "^1.5.173",
@@ -3988,6 +4020,25 @@
        "node": ">=8"
      }
    },
+    "node_modules/call-bind": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz",
+      "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.0",
+        "es-define-property": "^1.0.0",
+        "get-intrinsic": "^1.2.4",
+        "set-function-length": "^1.2.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/call-bind-apply-helpers": {
      "version": "1.0.2",
      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
@@ -4002,6 +4053,23 @@
        "node": ">= 0.4"
      }
    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/callsites": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
@@ -4122,6 +4190,22 @@
        "node": ">= 6"
      }
    },
+    "node_modules/ci-info": {
+      "version": "3.9.0",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz",
+      "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/sibiraj-s"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
    "node_modules/class-variance-authority": {
      "version": "0.7.1",
      "resolved": "https://registry.npmjs.org/class-variance-authority/-/class-variance-authority-0.7.1.tgz",
@@ -4418,6 +4502,7 @@
      "resolved": "https://registry.npmjs.org/date-fns/-/date-fns-3.6.0.tgz",
      "integrity": "sha512-fRHTG8g/Gif+kSh50gaGEdToemgfj74aRX3swtiouboip5JDLAyDE9F11nHMIcvOaXeOC6D7SpNhi7uFyB7Uww==",
      "license": "MIT",
+      "peer": true,
      "funding": {
        "type": "github",
        "url": "https://github.com/sponsors/kossnocorp"
@@ -4471,6 +4556,24 @@
      "dev": true,
      "license": "MIT"
    },
+    "node_modules/define-data-property": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/delayed-stream": {
      "version": "1.0.0",
      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
@@ -4514,8 +4617,7 @@
      "resolved": "https://registry.npmjs.org/dom-accessibility-api/-/dom-accessibility-api-0.5.16.tgz",
      "integrity": "sha512-X7BJ2yElsnOJ30pZF4uIIDfBEVgF4XEBxL9Bxhy6dnrm5hkzqmsWHGTiHqRiITNhMyFLyAiWndIJP7Z1NTteDg==",
      "dev": true,
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
    },
    "node_modules/dom-helpers": {
      "version": "5.2.1",
@@ -4573,7 +4675,8 @@
      "version": "8.6.0",
      "resolved": "https://registry.npmjs.org/embla-carousel/-/embla-carousel-8.6.0.tgz",
      "integrity": "sha512-SjWyZBHJPbqxHOzckOfo8lHisEaJWmwd23XppYFYVh10bU66/Pn5tkVkbkCMZVdbUE5eTCI2nD8OyIP4Z+uwkA==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
    },
    "node_modules/embla-carousel-react": {
      "version": "8.6.0",
@@ -4762,6 +4865,7 @@
      "integrity": "sha512-LSehfdpgMeWcTZkWZVIJl+tkZ2nuSkyyB9C27MZqFWXuph7DvaowgcTvKqxvpLW1JZIk8PN7hFY3Rj9LQ7m7lg==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@eslint-community/eslint-utils": "^4.2.0",
        "@eslint-community/regexpp": "^4.12.1",
@@ -5083,6 +5187,16 @@
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
+    "node_modules/find-yarn-workspace-root": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/find-yarn-workspace-root/-/find-yarn-workspace-root-2.0.0.tgz",
+      "integrity": "sha512-1IMnbjt4KzsQfnhnzNd8wUEgXZ44IzZaZmnLYx7D5FZlaHt2gW20Cri8Q+E/t5tIj4+epTBub+2Zxu/vNILzqQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "micromatch": "^4.0.2"
+      }
+    },
    "node_modules/flat-cache": {
      "version": "4.0.1",
      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
@@ -5178,6 +5292,31 @@
        }
      }
    },
+    "node_modules/fs-extra": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
+      "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/fs-extra/node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
    "node_modules/fsevents": {
      "version": "2.3.3",
      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -5341,6 +5480,13 @@
        "url": "https://github.com/sponsors/ljharb"
      }
    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
    "node_modules/graphemer": {
      "version": "1.4.0",
      "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",
@@ -5358,6 +5504,19 @@
        "node": ">=8"
      }
    },
+    "node_modules/has-property-descriptors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/has-symbols": {
      "version": "1.1.0",
      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
@@ -5567,6 +5726,22 @@
        "url": "https://github.com/sponsors/ljharb"
      }
    },
+    "node_modules/is-docker": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+      "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "is-docker": "cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
    "node_modules/is-extglob": {
      "version": "2.1.1",
      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
@@ -5613,6 +5788,26 @@
      "dev": true,
      "license": "MIT"
    },
+    "node_modules/is-wsl": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+      "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz",
+      "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==",
+      "dev": true,
+      "license": "MIT"
+    },
    "node_modules/isexe": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -5689,6 +5884,7 @@
      "integrity": "sha512-SYhBvTh89tTfCD/CRdSOm13mOBa42iTaTyfyEWBdKcGdPxPtLFBXuHR8XHb33YNYaP+lLbmSvBTsnoesCNJEsQ==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "abab": "^2.0.6",
        "acorn": "^8.8.1",
@@ -5742,6 +5938,14 @@
        "node": ">=6"
      }
    },
+    "node_modules/json-bigint": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-bigint/-/json-bigint-1.0.0.tgz",
+      "integrity": "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ==",
+      "dependencies": {
+        "bignumber.js": "^9.0.0"
+      }
+    },
    "node_modules/json-buffer": {
      "version": "3.0.1",
      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
@@ -5756,6 +5960,26 @@
      "dev": true,
      "license": "MIT"
    },
+    "node_modules/json-stable-stringify": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify/-/json-stable-stringify-1.3.0.tgz",
+      "integrity": "sha512-qtYiSSFlwot9XHtF9bD9c7rwKjr+RecWT//ZnPvSmEjpV5mmPOCN4j8UjY5hbjNkOwZ/jQv3J6R1/pL7RwgMsg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "isarray": "^2.0.5",
+        "jsonify": "^0.0.1",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/json-stable-stringify-without-jsonify": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
@@ -5776,6 +6000,39 @@
        "node": ">=6"
      }
    },
+    "node_modules/jsonfile": {
+      "version": "6.2.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.0.tgz",
+      "integrity": "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/jsonfile/node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/jsonify": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/jsonify/-/jsonify-0.0.1.tgz",
+      "integrity": "sha512-2/Ki0GcmuqSrgFyelQq9M05y7PS0mEwuIzrf3f1fPqkVDVRvZrPZtVSMHxdgo8Aq0sxAOb/cr2aqqA3LeWHVPg==",
+      "dev": true,
+      "license": "Public Domain",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/keyv": {
      "version": "4.5.4",
      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
@@ -5786,6 +6043,16 @@
        "json-buffer": "3.0.1"
      }
    },
+    "node_modules/klaw-sync": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/klaw-sync/-/klaw-sync-6.0.0.tgz",
+      "integrity": "sha512-nIeuVSzdCCs6TDPTqI8w1Yre34sSq7AkZ4B3sfOBbI2CgVSB4Du4aLQijFU2+lhAFCwt9+42Hel6lQNIv6AntQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.1.11"
+      }
+    },
    "node_modules/levn": {
      "version": "0.4.1",
      "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz",
@@ -6344,7 +6611,6 @@
      "integrity": "sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "bin": {
        "lz-string": "bin/bin.js"
      }
@@ -6437,6 +6703,16 @@
        "node": "*"
      }
    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
    "node_modules/minipass": {
      "version": "7.1.2",
      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz",
@@ -6591,12 +6867,39 @@
        "node": ">= 6"
      }
    },
+    "node_modules/object-keys": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
    "node_modules/ogl": {
      "version": "1.0.11",
      "resolved": "https://registry.npmjs.org/ogl/-/ogl-1.0.11.tgz",
      "integrity": "sha512-kUpC154AFfxi16pmZUK4jk3J+8zxwTWGPo03EoYA8QPbzikHoaC82n6pNTbd+oEaJonaE8aPWBlX7ad9zrqLsA==",
      "license": "Unlicense"
    },
+    "node_modules/open": {
+      "version": "7.4.2",
+      "resolved": "https://registry.npmjs.org/open/-/open-7.4.2.tgz",
+      "integrity": "sha512-MVHddDVweXZF3awtlAS+6pgKLlm/JgxZ90+/NBurBoQctVOOB/zDdVjcyPzQ+0laDGbsWgrRkflI65sQeOgT9Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^2.0.0",
+        "is-wsl": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
    "node_modules/optionator": {
      "version": "0.9.4",
      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -6679,6 +6982,36 @@
        "url": "https://github.com/inikulin/parse5?sponsor=1"
      }
    },
+    "node_modules/patch-package": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/patch-package/-/patch-package-8.0.1.tgz",
+      "integrity": "sha512-VsKRIA8f5uqHQ7NGhwIna6Bx6D9s/1iXlA1hthBVBEbkq+t4kXD0HHt+rJhf/Z+Ci0F/HCB2hvn0qLdLG+Qxlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@yarnpkg/lockfile": "^1.1.0",
+        "chalk": "^4.1.2",
+        "ci-info": "^3.7.0",
+        "cross-spawn": "^7.0.3",
+        "find-yarn-workspace-root": "^2.0.0",
+        "fs-extra": "^10.0.0",
+        "json-stable-stringify": "^1.0.2",
+        "klaw-sync": "^6.0.0",
+        "minimist": "^1.2.6",
+        "open": "^7.4.2",
+        "semver": "^7.5.3",
+        "slash": "^2.0.0",
+        "tmp": "^0.2.4",
+        "yaml": "^2.2.2"
+      },
+      "bin": {
+        "patch-package": "index.js"
+      },
+      "engines": {
+        "node": ">=14",
+        "npm": ">5"
+      }
+    },
    "node_modules/path-exists": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -6792,6 +7125,7 @@
        }
      ],
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "nanoid": "^3.3.11",
        "picocolors": "^1.1.1",
@@ -6932,7 +7266,6 @@
      "integrity": "sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "ansi-regex": "^5.0.1",
        "ansi-styles": "^5.0.0",
@@ -6948,7 +7281,6 @@
      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "engines": {
        "node": ">=8"
      }
@@ -6959,7 +7291,6 @@
      "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
      "dev": true,
      "license": "MIT",
-      "peer": true,
      "engines": {
        "node": ">=10"
      },
@@ -6972,8 +7303,7 @@
      "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",
      "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==",
      "dev": true,
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
    },
    "node_modules/prop-types": {
      "version": "15.8.1",
@@ -7047,6 +7377,7 @@
      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0"
      },
@@ -7073,6 +7404,7 @@
      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0",
        "scheduler": "^0.23.2"
@@ -7086,6 +7418,7 @@
      "resolved": "https://registry.npmjs.org/react-hook-form/-/react-hook-form-7.61.1.tgz",
      "integrity": "sha512-2vbXUFDYgqEgM2RcXcAT2PwDW/80QARi+PKmHy5q2KhuKvOlG8iIYgf7eIlIANR5trW9fJbP4r5aub3a4egsew==",
      "license": "MIT",
+      "peer": true,
      "engines": {
        "node": ">=18.0.0"
      },
@@ -7507,6 +7840,24 @@
        "node": ">=10"
      }
    },
+    "node_modules/set-function-length": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2",
+        "get-intrinsic": "^1.2.4",
+        "gopd": "^1.0.1",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
    "node_modules/shebang-command": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
@@ -7547,6 +7898,16 @@
        "url": "https://github.com/sponsors/isaacs"
      }
    },
+    "node_modules/slash": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-2.0.0.tgz",
+      "integrity": "sha512-ZYKh3Wh2z1PpEXWr0MpSBZ0V6mZHAQfYevttO11c51CaWjGTaadiKZ+wVt1PbMlDV5qhMFslpZCemhwOK7C89A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
    "node_modules/sonner": {
      "version": "1.7.4",
      "resolved": "https://registry.npmjs.org/sonner/-/sonner-1.7.4.tgz",
@@ -7811,6 +8172,7 @@
      "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz",
      "integrity": "sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==",
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@alloc/quick-lru": "^5.2.0",
        "arg": "^5.0.2",
@@ -7877,7 +8239,8 @@
      "version": "0.182.0",
      "resolved": "https://registry.npmjs.org/three/-/three-0.182.0.tgz",
      "integrity": "sha512-GbHabT+Irv+ihI1/f5kIIsZ+Ef9Sl5A1Y7imvS5RQjWgtTPfPnZ43JmlYI7NtCRDK9zir20lQpfg8/9Yd02OvQ==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
    },
    "node_modules/tiny-invariant": {
      "version": "1.3.3",
@@ -7940,6 +8303,7 @@
      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "engines": {
        "node": ">=12"
      },
@@ -7977,6 +8341,16 @@
        "node": ">=14.0.0"
      }
    },
+    "node_modules/tmp": {
+      "version": "0.2.5",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.5.tgz",
+      "integrity": "sha512-voyz6MApa1rQGUxT3E+BK7/ROe8itEx7vD8/HEvt4xwXucvQ5G5oeEiHkmHZJuBO21RpOf+YYm9MOivj709jow==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.14"
+      }
+    },
    "node_modules/to-regex-range": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
@@ -8062,6 +8436,7 @@
      "integrity": "sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==",
      "dev": true,
      "license": "Apache-2.0",
+      "peer": true,
      "bin": {
        "tsc": "bin/tsc",
        "tsserver": "bin/tsserver"
@@ -8262,6 +8637,7 @@
      "integrity": "sha512-qO3aKv3HoQC8QKiNSTuUM1l9o/XX3+c+VTgLHbJWHZGeTPVAg2XwazI9UWzoxjIJCGCV2zU60uqMzjeLZuULqA==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "esbuild": "^0.21.3",
        "postcss": "^8.4.43",
--- a/package.json
+++ b/package.json
@@ -6,6 +6,9 @@
  "scripts": {
    "dev": "vite",
    "build": "vite build",
+    "postinstall": "patch-package",
+    "setup:env": "node scripts/setup-env.cjs",
+    "deploy:server": "npm run setup:env && vite build",
    "build:dev": "vite build --mode development",
    "lint": "eslint .",
    "preview": "vite preview",
@@ -44,6 +47,7 @@
    "@react-three/fiber": "^8.18.0",
    "@tabler/icons-react": "^3.36.1",
    "@tanstack/react-query": "^5.83.0",
+    "appwrite": "^22.0.0",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
    "cmdk": "^1.1.1",
@@ -84,6 +88,7 @@
    "globals": "^15.15.0",
    "jsdom": "^20.0.3",
    "lovable-tagger": "^1.1.13",
+    "patch-package": "^8.0.1",
    "postcss": "^8.5.6",
    "tailwindcss": "^3.4.17",
    "typescript": "^5.8.3",
--- a/patches/appwrite+22.0.0.patch
+++ b/patches/appwrite+22.0.0.patch
@@ -0,0 +1,13 @@
+diff --git a/node_modules/appwrite/dist/esm/sdk.js b/node_modules/appwrite/dist/esm/sdk.js
+index b1fcf3b..4ba8d80 100644
+--- a/node_modules/appwrite/dist/esm/sdk.js
+++ b/node_modules/appwrite/dist/esm/sdk.js
+@@ -466,7 +466,7 @@ const JSONbigSerializer = JSONbigModule({ useNativeBigInt: true });
+ const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+ const MIN_SAFE = BigInt(Number.MIN_SAFE_INTEGER);
+ function reviver(_key, value) {
+-    if (BigNumber.isBigNumber(value)) {
+    if (value && value._isBigNumber === true) {
+         if (value.isInteger()) {
+             const str = value.toFixed();
+             const bi = BigInt(str);
--- a/patches/json-bigint+1.0.0.patch
+++ b/patches/json-bigint+1.0.0.patch
@@ -0,0 +1,31 @@
+diff --git a/node_modules/json-bigint/lib/parse.js b/node_modules/json-bigint/lib/parse.js
+index bb4e5eb..0ea96e8 100644
+--- a/node_modules/json-bigint/lib/parse.js
+++ b/node_modules/json-bigint/lib/parse.js
+@@ -206,6 +206,7 @@ var json_parse = function (options) {
+         error('Bad number');
+       } else {
+         if (BigNumber == null) BigNumber = require('bignumber.js');
+        if (typeof BigNumber === 'object' && BigNumber && typeof BigNumber.default === 'function') BigNumber = BigNumber.default;
+         //if (number > 9007199254740992 || number < -9007199254740992)
+         // Bignumber has stricter check: everything with length > 15 digits disallowed
+         if (string.length > 15)
+diff --git a/node_modules/json-bigint/lib/stringify.js b/node_modules/json-bigint/lib/stringify.js
+index 3bd5269..ab80d3e 100644
+--- a/node_modules/json-bigint/lib/stringify.js
+++ b/node_modules/json-bigint/lib/stringify.js
+@@ -1,4 +1,5 @@
+ var BigNumber = require('bignumber.js');
+if (typeof BigNumber === 'object' && BigNumber && typeof BigNumber.default === 'function') BigNumber = BigNumber.default;
+ 
+ /*
+     json2.js
+@@ -215,7 +216,7 @@ var JSON = module.exports;
+             mind = gap,
+             partial,
+             value = holder[key],
+-            isBigNumber = value != null && (value instanceof BigNumber || BigNumber.isBigNumber(value));
+            isBigNumber = value != null && (value instanceof BigNumber || (value && value._isBigNumber === true));
+ 
+ // If the value has a toJSON method, call it to obtain a replacement value.
+ 
--- a/public/loesung.jpg
+++ b/public/loesung.jpg
--- a/public/problem.jpg
+++ b/public/problem.jpg
--- a/public/problem_blitz.jpg
+++ b/public/problem_blitz.jpg
--- a/scripts/setup-env.cjs
+++ b/scripts/setup-env.cjs
@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Legt .env aus .env.example an, falls .env noch nicht existiert.
+ * .cjs damit es unter "type": "module" (package.json) mit require() läuft.
+ * Für Deployment: deploy.sh kann vor dem Build .env.local aus Container-Env schreiben.
+ */
+const fs = require("fs");
+const path = require("path");
+
+const envPath = path.join(process.cwd(), ".env");
+const examplePath = path.join(process.cwd(), ".env.example");
+
+if (fs.existsSync(envPath)) {
+  console.log(".env existiert bereits – nichts geändert.");
+  process.exit(0);
+}
+
+if (!fs.existsSync(examplePath)) {
+  console.error(".env.example nicht gefunden. Bitte manuell .env anlegen.");
+  process.exit(1);
+}
+
+fs.copyFileSync(examplePath, envPath);
+console.log(".env wurde aus .env.example erstellt. Bitte danach 'npm run build' ausführen.");
+process.exit(0);
--- a/scripts/vite-json-bigint-bignumber.js
+++ b/scripts/vite-json-bigint-bignumber.js
@@ -0,0 +1,43 @@
+/**
+ * Behebt "Right-hand side of 'instanceof' is not callable" bei json-bigint.
+ * Beim Vite-Build liefert require('bignumber.js') bei ESM-Alias das Modul-Objekt
+ * { default: BigNumber }; json-bigint nutzt aber "value instanceof BigNumber".
+ * Wir setzen BigNumber auf den echten Konstruktor (default-Export), falls vorhanden.
+ */
+const DEFAULT_EXTRACT =
+  "\nif (typeof BigNumber === 'object' && BigNumber && typeof BigNumber.default === 'function') BigNumber = BigNumber.default;";
+
+export function jsonBigintBigNumberFix() {
+  return {
+    name: "json-bigint-bignumber-fix",
+    enforce: "pre",
+    transform(src, id) {
+      const idNorm = id.replace(/\\/g, "/");
+      if (!idNorm.includes("json-bigint")) return null;
+      const isStringify = idNorm.includes("stringify.js");
+      const isParse = idNorm.includes("parse.js");
+      if (!isStringify && !isParse) return null;
+
+      if (isStringify) {
+        const firstLine = "var BigNumber = require('bignumber.js');";
+        if (!src.includes(firstLine)) return null;
+        return {
+          code: src.replace(firstLine, firstLine + DEFAULT_EXTRACT),
+          map: null,
+        };
+      }
+
+      if (isParse) {
+        const requireLine =
+          "if (BigNumber == null) BigNumber = require('bignumber.js');";
+        if (!src.includes(requireLine)) return null;
+        return {
+          code: src.replace(requireLine, requireLine + DEFAULT_EXTRACT),
+          map: null,
+        };
+      }
+
+      return null;
+    },
+  };
+}
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -16,7 +16,7 @@ const App = () => (
    <TooltipProvider>
      <Toaster />
      <Sonner />
-      <BrowserRouter>
+      <BrowserRouter future={{ v7_startTransition: true, v7_relativeSplatPath: true }}>
        <Routes>
          <Route path="/" element={<Index />} />
          <Route path="/kontakt" element={<ContactPage />} />
--- a/src/components/ProblemSection.tsx
+++ b/src/components/ProblemSection.tsx
@@ -24,6 +24,14 @@ const ProblemSection = () => {

  return (
    <section className="section-problem-solution py-24 md:py-32 relative overflow-hidden">
+      {/* Hintergrundbild: nur Blitze rechts, auf Handy maximale Breite */}
+      <div
+        className="problem-section-bg absolute inset-0 bg-right bg-no-repeat opacity-[0.3] z-0"
+        style={{
+          backgroundImage: "url(/problem_blitz.jpg)",
+        }}
+        aria-hidden
+      />
      <div className="absolute inset-0 w-full overflow-hidden z-0">
        <LightRays
          raysOrigin="top-center"
--- a/src/components/SolutionSection.tsx
+++ b/src/components/SolutionSection.tsx
@@ -13,6 +13,14 @@ const SolutionSection = () => {

  return (
    <section className="section-problem-solution py-24 md:py-32 relative overflow-hidden">
+      {/* Hintergrundbild mittig, auf Handy maximale Breite */}
+      <div
+        className="solution-section-bg absolute inset-0 bg-center bg-no-repeat opacity-[0.3] z-0"
+        style={{
+          backgroundImage: "url(/loesung.jpg)",
+        }}
+        aria-hidden
+      />
      <div className="absolute inset-0 w-full overflow-hidden z-0">
        <LightRays
          raysOrigin="top-center"
--- a/src/components/Values.tsx
+++ b/src/components/Values.tsx
@@ -36,12 +36,11 @@ const Values = () => {

  return (
    <section id="features" className="py-24 md:py-32 bg-background relative overflow-hidden">
-      {/* Hintergrundbild: kleiner, leicht transparent */}
+      {/* Hintergrundbild: auf Handy maximale Breite */}
      <div
-        className="absolute inset-0 bg-right bg-no-repeat opacity-[0.3]"
+        className="values-section-bg absolute inset-0 bg-right bg-no-repeat opacity-[0.3]"
        style={{
          backgroundImage: "url(/backgroud_effect.png)",
-          backgroundSize: "45%",
        }}
        aria-hidden
      />
--- a/src/index.css
+++ b/src/index.css
@@ -139,6 +139,7 @@
    @apply bg-background text-foreground antialiased;
    font-family: 'Inter', system-ui, sans-serif;
    letter-spacing: -0.01em;
+    position: relative; /* für Motion useScroll – Scroll-Container braucht nicht-static position */
  }

  h1, h2, h3, h4, h5, h6 {
@@ -159,6 +160,36 @@
    background-color: hsl(var(--background));
  }

+  /* Problem-Section Hintergrundbild: auf Handy maximale Breite, sonst 45% */
+  .problem-section-bg {
+    background-size: 45%;
+  }
+  @media (max-width: 768px) {
+    .problem-section-bg {
+      background-size: 100%;
+    }
+  }
+
+  /* Lösung-Section Hintergrundbild: auf Handy maximale Breite, sonst 45% */
+  .solution-section-bg {
+    background-size: 45%;
+  }
+  @media (max-width: 768px) {
+    .solution-section-bg {
+      background-size: 100%;
+    }
+  }
+
+  /* Was Sie bekommen (Values) Hintergrundbild: auf Handy maximale Breite, sonst 45% */
+  .values-section-bg {
+    background-size: 45%;
+  }
+  @media (max-width: 768px) {
+    .values-section-bg {
+      background-size: 100%;
+    }
+  }
+
  /* Leichter roter Tint auf Inhaltsblöcken der Problem-Sektion */
  .problem-section-tint {
    position: relative;
--- a/src/lib/appwrite.ts
+++ b/src/lib/appwrite.ts
@@ -0,0 +1,52 @@
+/**
+ * Appwrite-Anbindung für das Kontaktformular.
+ *
+ * In der Appwrite Console anlegen:
+ * 1. Database (z. B. ID: "contacts")
+ * 2. Collection (z. B. ID: "messages") mit String-Attributen: name, email, company, message
+ * 3. Unter "Settings" der Collection: Create-Berechtigung für "Any" aktivieren (öffentliches Formular)
+ * 4. IDs in .env setzen: VITE_APPWRITE_DATABASE_ID, VITE_APPWRITE_CONTACT_COLLECTION_ID
+ */
+import { Client, Databases, ID } from "appwrite";
+
+const CONTACT_DATABASE_ID = import.meta.env.VITE_APPWRITE_DATABASE_ID ?? "698124a20035e8f6dc42";
+const CONTACT_COLLECTION_ID = import.meta.env.VITE_APPWRITE_CONTACT_COLLECTION_ID ?? "contact_submissions";
+
+function getDatabases(): Databases {
+  const endpoint = import.meta.env.VITE_APPWRITE_ENDPOINT;
+  const projectId = import.meta.env.VITE_APPWRITE_PROJECT_ID;
+  if (!endpoint || !projectId) {
+    throw new Error(
+      "Appwrite ist nicht konfiguriert. Bitte VITE_APPWRITE_ENDPOINT und VITE_APPWRITE_PROJECT_ID setzen. " +
+        "Lokal: .env anlegen (z. B. mit „npm run setup:env“) und Build/Dev-Server neu starten. " +
+        "Server: gleiche Variablen in der Build-Umgebung setzen (z. B. in .env vor „npm run build“)."
+    );
+  }
+  const client = new Client().setEndpoint(endpoint).setProject(projectId);
+  return new Databases(client);
+}
+
+let _databases: Databases | null = null;
+
+export type ContactFormData = {
+  name: string;
+  email: string;
+  company: string;
+  message: string;
+};
+
+export async function createContactDocument(data: ContactFormData) {
+  if (!_databases) _databases = getDatabases();
+  return _databases.createDocument<ContactFormData>(
+    CONTACT_DATABASE_ID,
+    CONTACT_COLLECTION_ID,
+    ID.unique(),
+    {
+      name: data.name,
+      email: data.email,
+      company: data.company,
+      message: data.message,
+    },
+    [] // Keine Dokument-Permissions; nur Collection-Berechtigung „Create für Any“ wird genutzt
+  );
+}
--- a/src/pages/Contact.tsx
+++ b/src/pages/Contact.tsx
@@ -6,6 +6,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { Label } from "@/components/ui/label";
 import { ArrowLeft, Send } from "lucide-react";
 import { useToast } from "@/hooks/use-toast";
+import { createContactDocument } from "@/lib/appwrite";

 const Contact = () => {
  const { toast } = useToast();
@@ -29,17 +30,23 @@ const Contact = () => {
  const handleSubmit = async (e: React.FormEvent) => {
    e.preventDefault();
    setIsSubmitting(true);
-
-    // Simulate form submission
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-
+    try {
+      await createContactDocument(formData);
      toast({
        title: "Nachricht gesendet!",
        description: "Wir melden uns innerhalb von 24 Stunden bei Ihnen.",
      });
-
      setFormData({ name: "", email: "", company: "", message: "" });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Speichern fehlgeschlagen.";
+      toast({
+        variant: "destructive",
+        title: "Fehler beim Senden",
+        description: message,
+      });
+    } finally {
      setIsSubmitting(false);
+    }
  };

  return (
--- a/src/vite-env.d.ts
+++ b/src/vite-env.d.ts
@@ -1 +1,12 @@
 /// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_APPWRITE_PROJECT_ID: string;
+  readonly VITE_APPWRITE_ENDPOINT: string;
+  readonly VITE_APPWRITE_DATABASE_ID?: string;
+  readonly VITE_APPWRITE_CONTACT_COLLECTION_ID?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
--- a/starter-for-react/.env.example
+++ b/starter-for-react/.env.example
@@ -0,0 +1,2 @@
+VITE_APPWRITE_PROJECT_ID="696b82270034001dab69"
+VITE_APPWRITE_ENDPOINT="https://appwrite.webklar.com/v1"
--- a/starter-for-react/.gitignore
+++ b/starter-for-react/.gitignore
@@ -0,0 +1,26 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+.env
--- a/starter-for-react/LICENSE
+++ b/starter-for-react/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Appwrite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/starter-for-react/README.md
+++ b/starter-for-react/README.md
@@ -0,0 +1,26 @@
+# React starter kit with Appwrite
+
+Kickstart your React development with this ready-to-use starter project integrated with [Appwrite](https://www.appwrite.io)
+
+## 🚀Getting started
+
+###
+Clone the Project
+Clone this repository to your local machine using Git:
+
+`git clone https://github.com/appwrite/starter-for-react`
+
+## 🛠️ Development guid
+1. **Configure Appwrite**<br/>
+   Navigate to `.env` and update the values to match your Appwrite project credentials.
+2. **Customize as needed**<br/>
+   Modify the starter kit to suit your app's requirements. Adjust UI, features, or backend
+   integrations as per your needs.
+3. **Install dependencies**<br/>
+   Run `npm install` to install all dependencies.
+4. **Run the app**<br/>
+   Start the project by running `npm run dev`.
+
+## 💡 Additional notes
+- This starter project is designed to streamline your React development with Appwrite.
+- Refer to the [Appwrite documentation](https://appwrite.io/docs) for detailed integration guidance.
--- a/starter-for-react/eslint.config.js
+++ b/starter-for-react/eslint.config.js
@@ -0,0 +1,38 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import react from 'eslint-plugin-react'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+
+export default [
+  { ignores: ['dist'] },
+  {
+    files: ['**/*.{js,jsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        ecmaFeatures: { jsx: true },
+        sourceType: 'module',
+      },
+    },
+    settings: { react: { version: '18.3' } },
+    plugins: {
+      react,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...react.configs.recommended.rules,
+      ...react.configs['jsx-runtime'].rules,
+      ...reactHooks.configs.recommended.rules,
+      'react/jsx-no-target-blank': 'off',
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+]
--- a/starter-for-react/index.html
+++ b/starter-for-react/index.html
@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin />
+    <link
+            href="https://fonts.googleapis.com/css2?family=Fira+Code&family=Inter:opsz,wght@14..32,100..900&family=Poppins:wght@300;400&display=swap"
+            rel="stylesheet"
+    />
+    <link rel="icon" type="image/svg+xml" href="/appwrite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Appwrite + React</title>
+  </head>
+  <body class="bg-[#FAFAFB] font-[Inter] text-sm text-[#56565C]">
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>
--- a/starter-for-react/package-lock.json
+++ b/starter-for-react/package-lock.json
--- a/starter-for-react/package.json
+++ b/starter-for-react/package.json
@@ -0,0 +1,33 @@
+{
+  "name": "react-starter-kit-for-appwrite",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@appwrite.io/pink-icons": "^1.0.0",
+    "@tailwindcss/vite": "^4.0.14",
+    "appwrite": "^21.2.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.14"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.19.0",
+    "@types/react": "^19.0.8",
+    "@types/react-dom": "^19.0.3",
+    "@vitejs/plugin-react": "^4.3.4",
+    "eslint": "^9.19.0",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.18",
+    "globals": "^15.14.0",
+    "prettier": "3.5.3",
+    "vite": "^6.1.0"
+  }
+}
--- a/starter-for-react/public/appwrite.svg
+++ b/starter-for-react/public/appwrite.svg
@@ -0,0 +1,8 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <path
+            d="M24.4429 16.4322V21.9096H10.7519C6.76318 21.9096 3.28044 19.7067 1.4171 16.4322C1.14622 15.9561 0.909137 15.4567 0.710264 14.9383C0.319864 13.9225 0.0744552 12.8325 0 11.6952V10.2143C0.0161646 9.96089 0.0416361 9.70942 0.0749451 9.46095C0.143032 8.95105 0.245898 8.45211 0.381093 7.96711C1.66006 3.36909 5.81877 0 10.7519 0C15.6851 0 19.8433 3.36909 21.1223 7.96711H15.2682C14.3072 6.4683 12.6437 5.4774 10.7519 5.4774C8.86017 5.4774 7.19668 6.4683 6.23562 7.96711C5.9427 8.42274 5.71542 8.92516 5.56651 9.46095C5.43425 9.93599 5.36371 10.4369 5.36371 10.9548C5.36371 12.5248 6.01324 13.94 7.05463 14.9383C8.01961 15.865 9.32061 16.4322 10.7519 16.4322H24.4429Z"
+            fill="#FD366E" />
+    <path
+            d="M24.4429 9.46094V14.9383H14.4492C15.4906 13.94 16.1401 12.5248 16.1401 10.9548C16.1401 10.4369 16.0696 9.93598 15.9373 9.46094H24.4429Z"
+            fill="#FD366E" />
+</svg>
--- a/starter-for-react/public/react.svg
+++ b/starter-for-react/public/react.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
+     aria-hidden="true" role="img" className="iconify iconify--logos" width="35.93" height="32"
+     preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228">
+    <path fill="#00D8FF"
+          d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path>
+</svg>
--- a/starter-for-react/src/App.css
+++ b/starter-for-react/src/App.css
@@ -0,0 +1,20 @@
+@import "tailwindcss";
+
+summary::-webkit-details-marker {
+  display: none
+}
+
+.checker-background::before {
+  content: "";
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  background-image: linear-gradient(#e6e6e690 1px, transparent 1px),
+  linear-gradient(90deg, #e6e6e690 1px, transparent 1px);
+  background-size: 3.7em 3.7em;
+  mask-image: radial-gradient(ellipse at 50% 40%, black 0%, transparent 55%);
+  z-index: -1;
+  background-position-x: center;
+}
--- a/starter-for-react/src/App.jsx
+++ b/starter-for-react/src/App.jsx
@@ -0,0 +1,311 @@
+import { useState, useRef, useEffect, useCallback } from "react";
+import "./App.css";
+import { client } from "./lib/appwrite";
+import { AppwriteException } from "appwrite";
+import AppwriteSvg from "../public/appwrite.svg";
+import ReactSvg from "../public/react.svg";
+
+function App() {
+  const [detailHeight, setDetailHeight] = useState(55);
+  const [logs, setLogs] = useState([]);
+  const [status, setStatus] = useState("idle");
+  const [showLogs, setShowLogs] = useState(false);
+
+  const detailsRef = useRef(null);
+
+  const updateHeight = useCallback(() => {
+    if (detailsRef.current) {
+      setDetailHeight(detailsRef.current.clientHeight);
+    }
+  }, [logs, showLogs]);
+
+  useEffect(() => {
+    updateHeight();
+    window.addEventListener("resize", updateHeight);
+    return () => window.removeEventListener("resize", updateHeight);
+  }, [updateHeight]);
+
+  useEffect(() => {
+    if (!detailsRef.current) return;
+    detailsRef.current.addEventListener("toggle", updateHeight);
+
+    return () => {
+      if (!detailsRef.current) return;
+      detailsRef.current.removeEventListener("toggle", updateHeight);
+    };
+  }, []);
+
+  async function sendPing() {
+    if (status === "loading") return;
+    setStatus("loading");
+    try {
+      const result = await client.ping();
+      const log = {
+        date: new Date(),
+        method: "GET",
+        path: "/v1/ping",
+        status: 200,
+        response: JSON.stringify(result),
+      };
+      setLogs((prevLogs) => [log, ...prevLogs]);
+      setStatus("success");
+    } catch (err) {
+      const log = {
+        date: new Date(),
+        method: "GET",
+        path: "/v1/ping",
+        status: err instanceof AppwriteException ? err.code : 500,
+        response:
+          err instanceof AppwriteException
+            ? err.message
+            : "Something went wrong",
+      };
+      setLogs((prevLogs) => [log, ...prevLogs]);
+      setStatus("error");
+    }
+    setShowLogs(true);
+  }
+
+  return (
+    <main
+      className="checker-background flex flex-col items-center p-5"
+      style={{ marginBottom: `${detailHeight}px` }}
+    >
+      <div className="mt-25 flex w-full max-w-[40em] items-center justify-center lg:mt-34">
+        <div className="rounded-[25%] border border-[#19191C0A] bg-[#F9F9FA] p-3 shadow-[0px_9.36px_9.36px_0px_hsla(0,0%,0%,0.04)]">
+          <div className="rounded-[25%] border border-[#FAFAFB] bg-white p-5 shadow-[0px_2px_12px_0px_hsla(0,0%,0%,0.03)] lg:p-9">
+            <img
+              alt={"React logo"}
+              src={ReactSvg}
+              className="h-14 w-14"
+              width={56}
+              height={56}
+            />
+          </div>
+        </div>
+        <div
+          className={`flex w-38 items-center transition-opacity duration-2500 ${status === "success" ? "opacity-100" : "opacity-0"}`}
+        >
+          <div className="to-[rgba(253, 54, 110, 0.15)] h-[1px] flex-1 bg-gradient-to-l from-[#f02e65]"></div>
+          <div className="icon-check flex h-5 w-5 items-center justify-center rounded-full border border-[#FD366E52] bg-[#FD366E14] text-[#FD366E]"></div>
+          <div className="to-[rgba(253, 54, 110, 0.15)] h-[1px] flex-1 bg-gradient-to-r from-[#f02e65]"></div>
+        </div>
+        <div className="rounded-[25%] border border-[#19191C0A] bg-[#F9F9FA] p-3 shadow-[0px_9.36px_9.36px_0px_hsla(0,0%,0%,0.04)]">
+          <div className="rounded-[25%] border border-[#FAFAFB] bg-white p-5 shadow-[0px_2px_12px_0px_hsla(0,0%,0%,0.03)] lg:p-9">
+            <img
+              alt={"Appwrite logo"}
+              src={AppwriteSvg}
+              className="h-14 w-14"
+              width={56}
+              height={56}
+            />
+          </div>
+        </div>
+      </div>
+
+      <section className="mt-12 flex h-52 flex-col items-center">
+        {status === "loading" ? (
+          <div className="flex flex-row gap-4">
+            <div role="status">
+              <svg
+                aria-hidden="true"
+                className="h-5 w-5 animate-spin fill-[#FD366E] text-gray-200 dark:text-gray-600"
+                viewBox="0 0 100 101"
+                fill="none"
+                xmlns="http://www.w3.org/2000/svg"
+              >
+                <path
+                  d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
+                  fill="currentColor"
+                />
+                <path
+                  d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
+                  fill="currentFill"
+                />
+              </svg>
+              <span className="sr-only">Loading...</span>
+            </div>
+            <span>Waiting for connection...</span>
+          </div>
+        ) : status === "success" ? (
+          <h1 className="font-[Poppins] text-2xl font-light text-[#2D2D31]">
+            Congratulations!
+          </h1>
+        ) : (
+          <h1 className="font-[Poppins] text-2xl font-light text-[#2D2D31]">
+            Check connection
+          </h1>
+        )}
+
+        <p className="mt-2 mb-8">
+          {status === "success" ? (
+            <span>You connected your app successfully.</span>
+          ) : status === "error" || status === "idle" ? (
+            <span>Send a ping to verify the connection</span>
+          ) : null}
+        </p>
+
+        <button
+          onClick={sendPing}
+          className={`cursor-pointer rounded-md bg-[#FD366E] px-2.5 py-1.5 ${status === "loading" ? "hidden" : "visible"}`}
+        >
+          <span className="text-white">Send a ping</span>
+        </button>
+      </section>
+
+      <div className="grid grid-rows-3 gap-7 lg:grid-cols-3 lg:grid-rows-none">
+        <div className="flex h-full w-72 flex-col gap-2 rounded-md border border-[#EDEDF0] bg-white p-4">
+          <h2 className="text-xl font-light text-[#2D2D31]">Edit your app</h2>
+          <p>
+            Edit{" "}
+            <code className="rounded-sm bg-[#EDEDF0] p-1">app/page.js</code> to
+            get started with building your app.
+          </p>
+        </div>
+        <a
+          href="https://cloud.appwrite.io"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <div className="flex h-full w-72 flex-col gap-2 rounded-md border border-[#EDEDF0] bg-white p-4">
+            <div className="flex flex-row items-center justify-between">
+              <h2 className="text-xl font-light text-[#2D2D31]">
+                Go to console
+              </h2>
+              <span className="icon-arrow-right text-[#D8D8DB]"></span>
+            </div>
+            <p>
+              Navigate to the console to control and oversee the Appwrite
+              services.
+            </p>
+          </div>
+        </a>
+
+        <a
+          href="https://appwrite.io/docs"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <div className="flex h-full w-72 flex-col gap-2 rounded-md border border-[#EDEDF0] bg-white p-4">
+            <div className="flex flex-row items-center justify-between">
+              <h2 className="text-xl font-light text-[#2D2D31]">
+                Explore docs
+              </h2>
+              <span className="icon-arrow-right text-[#D8D8DB]"></span>
+            </div>
+            <p>
+              Discover the full power of Appwrite by diving into our
+              documentation.
+            </p>
+          </div>
+        </a>
+      </div>
+
+      <aside className="fixed bottom-0 flex w-full cursor-pointer border-t border-[#EDEDF0] bg-white">
+        <details open={showLogs} ref={detailsRef} className={"w-full"}>
+          <summary className="flex w-full flex-row justify-between p-4 marker:content-none">
+            <div className="flex gap-2">
+              <span className="font-semibold">Logs</span>
+              {logs.length > 0 && (
+                <div className="flex items-center rounded-md bg-[#E6E6E6] px-2">
+                  <span className="font-semibold">{logs.length}</span>
+                </div>
+              )}
+            </div>
+            <div className="icon">
+              <span className="icon-cheveron-down" aria-hidden="true"></span>
+            </div>
+          </summary>
+          <div className="flex w-full flex-col lg:flex-row">
+            <div className="flex flex-col border-r border-[#EDEDF0]">
+              <div className="border-y border-[#EDEDF0] bg-[#FAFAFB] px-4 py-2 text-[#97979B]">
+                Project
+              </div>
+              <div className="grid grid-cols-2 gap-4 p-4">
+                <div className="flex flex-col">
+                  <span className="text-[#97979B]">Endpoint</span>
+                  <span className="truncate">
+                    {import.meta.env.VITE_APPWRITE_ENDPOINT}
+                  </span>
+                </div>
+                <div className="flex flex-col">
+                  <span className="text-[#97979B]">Project-ID</span>
+                  <span className="truncate">
+                    {import.meta.env.VITE_APPWRITE_PROJECT_ID}
+                  </span>
+                </div>
+                <div className="flex flex-col">
+                  <span className="text-[#97979B]">Project name</span>
+                  <span className="truncate">
+                    {import.meta.env.VITE_APPWRITE_PROJECT_NAME}
+                  </span>
+                </div>
+              </div>
+            </div>
+            <div className="flex-grow">
+              <table className="w-full">
+                <thead>
+                  <tr className="border-y border-[#EDEDF0] bg-[#FAFAFB] text-[#97979B]">
+                    {logs.length > 0 ? (
+                      <>
+                        <td className="w-52 py-2 pl-4">Date</td>
+                        <td>Status</td>
+                        <td>Method</td>
+                        <td className="hidden lg:table-cell">Path</td>
+                        <td className="hidden lg:table-cell">Response</td>
+                      </>
+                    ) : (
+                      <>
+                        <td className="py-2 pl-4">Logs</td>
+                      </>
+                    )}
+                  </tr>
+                </thead>
+                <tbody>
+                  {logs.length > 0 ? (
+                    logs.map((log) => (
+                      <tr>
+                        <td className="py-2 pl-4 font-[Fira_Code]">
+                          {log.date.toLocaleString("en-US", {
+                            month: "short",
+                            day: "numeric",
+                            hour: "2-digit",
+                            minute: "2-digit",
+                          })}
+                        </td>
+                        <td>
+                          {log.status > 400 ? (
+                            <div className="w-fit rounded-sm bg-[#FF453A3D] px-1 text-[#B31212]">
+                              {log.status}
+                            </div>
+                          ) : (
+                            <div className="w-fit rounded-sm bg-[#10B9813D] px-1 text-[#0A714F]">
+                              {log.status}
+                            </div>
+                          )}
+                        </td>
+                        <td>{log.method}</td>
+                        <td className="hidden lg:table-cell">{log.path}</td>
+                        <td className="hidden font-[Fira_Code] lg:table-cell">
+                          {log.response}
+                        </td>
+                      </tr>
+                    ))
+                  ) : (
+                    <tr>
+                      <td className="py-2 pl-4 font-[Fira_Code]">
+                        There are no logs to show
+                      </td>
+                    </tr>
+                  )}
+                </tbody>
+              </table>
+            </div>
+          </div>
+        </details>
+      </aside>
+    </main>
+  );
+}
+
+export default App;
--- a/starter-for-react/src/lib/appwrite.js
+++ b/starter-for-react/src/lib/appwrite.js
@@ -0,0 +1,10 @@
+import { Client, Account, Databases } from "appwrite";
+
+const client = new Client()
+    .setEndpoint(import.meta.env.VITE_APPWRITE_ENDPOINT)
+    .setProject(import.meta.env.VITE_APPWRITE_PROJECT_ID);
+
+const account = new Account(client);
+const databases = new Databases(client);
+
+export { client, account, databases };
--- a/starter-for-react/src/main.jsx
+++ b/starter-for-react/src/main.jsx
@@ -0,0 +1,10 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import "@appwrite.io/pink-icons";
+import App from './App.jsx'
+
+createRoot(document.getElementById('root')).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
--- a/starter-for-react/vite.config.js
+++ b/starter-for-react/vite.config.js
@@ -0,0 +1,8 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+})
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -5,6 +5,7 @@ import { componentTagger } from "lovable-tagger";

 // https://vitejs.dev/config/
 export default defineConfig(({ mode }) => ({
+  base: process.env.VITE_BASE_PATH || "/",
  server: {
    host: "::",
    port: 8080,
@@ -12,10 +13,18 @@ export default defineConfig(({ mode }) => ({
      overlay: false,
    },
  },
-  plugins: [react(), mode === "development" && componentTagger()].filter(Boolean),
+  plugins: [
+    react(),
+    mode === "development" && componentTagger(),
+  ].filter(Boolean),
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),
+      // ESM-Variante erzwingen, damit BigNumber.isBigNumber im Build verfügbar ist (Appwrite-SDK)
+      "bignumber.js": path.resolve(__dirname, "node_modules/bignumber.js/bignumber.mjs"),
    },
  },
+  optimizeDeps: {
+    include: ["bignumber.js"],
+  },
 }));
Author	SHA1	Message	Date
root	edb2ea6f8a	createDocument: permissions [] explizit übergeben (403-Versuch)	2026-02-07 09:42:57 +00:00
root	8fa7c2c078	Entfernen: Debug-Instrumentierung (localhost:7243) aus Contact und Appwrite	2026-02-07 09:17:47 +00:00
root	e3269518bd	Fix: json-bigint stringify nutzt _isBigNumber (behebt e.isBigNumber in prepareRequest)	2026-02-07 09:07:20 +00:00
root	95c4cefef1	Fix: Komma im Debug-Log-Objekt (Build-Syntax)	2026-02-07 08:58:34 +00:00
root	37327cc2c8	Debug: Instrumentierung für isBigNumber-Fehler (Console-Log + Fetch)	2026-02-07 08:58:09 +00:00
root	80c03411ae	Fix: Appwrite-Patch nutzt _isBigNumber statt isBigNumber (behebt 'e.isBigNumber is not a function' im Build)	2026-02-07 08:47:48 +00:00
Kenso Grimm	ac40edc468	appwrite 22.0.0 patch	2026-02-07 09:35:49 +01:00
Kenso Grimm	0986bc8173	appwrite verbindung auf local und domaene ueber ein plugin	2026-02-07 09:29:48 +01:00
Basilosaurusrex	305de38ff6	.env commit	2026-02-06 19:46:26 +01:00
Basilosaurusrex	82668796d6	appwrite anbindung	2026-02-06 18:22:04 +01:00
Kenso Grimm	6ad076473b	pics	2026-02-03 20:30:54 +01:00
KNSONWS	591c0eb4c7	fix	2026-02-03 19:51:36 +01:00
KNSONWS	2b39e0855f	Add Appwrite React starter as regular files	2026-02-03 19:44:28 +01:00
KNSONWS	8be94e4518	Add Appwrite React starter	2026-02-03 19:43:24 +01:00
KNSONWS	f2a3f47e07	form	2026-02-03 16:05:36 +01:00