Agile Developer Hilfe-Center › Agile Vibes

Variablen, Geheimnisse und Platzhalter

Umgebungsvariablen je Teil, verschlüsselte Geheimnisse und Platzhalter wie {{teil:backend:url}} verständlich erklärt.

Ihre App braucht Einstellungen: Adressen, Datenbank-Zugänge, API-Schlüssel. Agile Vibes unterscheidet dafür Variablen und Geheimnisse.

Variablen

Variablen gehören zu einem Teil (Frontend, Backend, Dienst) und sind lesbar. Sie stehen dem Prozess als Umgebungsvariablen zur Verfügung.

Ändern: Editor › Tab Einstellungen › Abschnitt Teile › Stift-Symbol am Teil. Im Dialog stehen unten die Variablen: links der Name, rechts der Wert. Mit + Variable fügen Sie eine hinzu, mit dem Mülleimer entfernen Sie sie. Speichern und neu starten übernimmt die Änderung; der Teil startet mit den neuen Werten neu.

Geheimnisse

Geheimnisse sind API-Schlüssel, Passwörter und Tokens.

  • Sie werden verschlüsselt gespeichert und stehen Ihrer App als Umgebungsvariable zur Verfügung.
  • Ihr Wert ist danach nie mehr lesbar: nicht in der Oberfläche, nicht über die API und nicht für die KI.
  • Sie gelten für das ganze Projekt.

Anlegen: Tab Einstellungen › Abschnitt Geheimnisse. NAME eintragen (Großbuchstaben, Ziffern, Unterstrich), Wert eintragen, Hinzufügen. Das Würfel-Symbol erzeugt einen sicheren Zufallswert, ideal für JWT_SECRET, SESSION_SECRET und ähnliche.
Ändern: Denselben Namen mit neuem Wert erneut hinzufügen.
Löschen: Mülleimer neben dem Geheimnis. Ihre App kann den Wert danach nicht mehr lesen.

Fragt die KI im Chat nach einem Schlüssel, landet Ihre Eingabe ebenfalls verschlüsselt in den Geheimnissen.

Platzhalter

Platzhalter sind Werte in doppelten geschweiften Klammern. Agile Vibes ersetzt sie beim Start durch die passenden Werte. So bleiben Ihre Einstellungen gültig, auch wenn sich Ports oder Adressen ändern.

  • {{port}}: Den Port des Teils (vor allem im Startbefehl)
  • {{teil:<name>:url}}: Öffentliche Adresse eines Teils, zum Beispiel …/_teil/backend. Für Variablen, die der Browser nutzt
  • {{teil:<name>:intern}}: Interne Adresse eines Teils in der Sandbox. Für Aufrufe vom Server aus
  • {{db:postgres:url}}: Verbindungs-URL der PostgreSQL-Datenbank des Projekts
  • {{db:mongo:url}}: Verbindungs-URL der MongoDB-Datenbank des Projekts

<name> ist der Kurzname des Teils. Beim Import heißt das Frontend web und ein einzelnes Backend backend; bei mehreren Backends wird der Ordner- oder Repository-Name verwendet. Den Kurznamen sehen Sie in den Logs und in der Adresse /_teil/<name>. Hinter einen Platzhalter darf ein Pfad, etwa {{teil:backend:url}}/api.

Beispiele

NEXT_PUBLIC_API_URL = {{teil:backend:url}}/api
API_INTERN          = {{teil:backend:intern}}
DATABASE_URL        = {{db:postgres:url}}
MONGODB_URI         = {{db:mongo:url}}
PORT                = {{port}}

Beim Import

Der Import-Assistent liest Variablennamen aus .env.example und dem Code und schlägt vor:

  • Verknüpfungen zwischen Teilen und Datenbank-URLs als Platzhalter (mit Hinweis „URL von …“ bzw. „Projektdatenbank“),
  • Geheimnisse mit Schloss-Symbol. Pflichtfelder sind mit * markiert. Bei internen Geheimnissen steht „Leer lassen: sicherer Zufallswert“; dann erzeugt Agile Vibes einen Wert mit 64 Zeichen. Schlüssel externer Dienste müssen Sie selbst eintragen.
  • Werte aus einer eingecheckten .env werden nicht übernommen, nur die Namen.

Tipps

  • Variablen mit NEXT_PUBLIC_ oder VITE_ landen im Browser. Legen Sie dort nie Geheimnisse ab.
  • Nach einer Änderung an Variablen startet der Teil neu. In Next.js braucht eine geänderte NEXT_PUBLIC_-Variable einen Neustart, den Agile Vibes beim Speichern auslöst.
  • Für die veröffentlichte App gelten dieselben Variablen und Geheimnisse. Veröffentlichen Sie nach einer Änderung neu (Aktualisieren), damit die Live-App sie bekommt.

Typische Fehler

  • App findet einen Schlüssel nicht: Name falsch geschrieben oder das Geheimnis wurde nach der letzten Veröffentlichung angelegt.
  • Platzhalter steht wörtlich in der App: Tippfehler im Platzhalter oder Name des Teils stimmt nicht.
  • Backend ist im Browser nicht erreichbar: Für Browser-Variablen url statt intern verwenden.

Häufige Fragen

Kann ich einen gespeicherten Wert wieder ansehen?
Nein. Das ist Absicht. Notieren Sie Schlüssel bei Bedarf in einem Passwort-Manager oder teilen Sie sie sicher mit Agile Secrets.

Sieht die KI meine Geheimnisse?
Nein. Die KI sieht nur die Namen, nie die Werte.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 14. Oktober 2026

Weitere Artikel zu Agile Vibes

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.