Agile Developer Hilfe-Center › Agile Vibes

Frontend und Backend aus zwei Repositorys importieren

Getrennte Repositorys oder Monorepo: wie Agile Vibes die Teile erkennt, verknüpft und unter einer Adresse startet.

Viele Apps bestehen aus einem Frontend (zum Beispiel Next.js oder Vite) und einem Backend (zum Beispiel Express, NestJS oder FastAPI), oft in zwei Repositorys. Agile Vibes holt beide in ein Projekt, verbindet sie und startet sie zusammen.

So laufen die Teile

  • Jeder Prozess ist ein Teil: Frontend, Backend oder Dienst. Höchstens ein Frontend je Projekt.
  • Alle Teile laufen unter einer Adresse. Das Frontend (Kurzname web) antwortet auf /, jeder weitere Teil unter /_teil/<name>/ (zum Beispiel /_teil/backend/). Gibt es nur ein Backend, heißt es backend, bei mehreren nach Ordner oder Repository. Der Präfix wird vor der Weitergabe an das Backend abgeschnitten.
  • Weil alles unter derselben Adresse liegt, brauchen Sie keine CORS-Einstellungen zwischen Frontend und Backend.
  • Wie viele Teile ein Projekt haben darf, hängt vom Tarif ab: Free 1, Start 3, Pro und Business 8.

Schritt für Schritt: zwei Repositorys

  1. /app › Bestehende App importieren.
  2. Erste Karte „Repository“: Quelle wählen und das Frontend-Repository angeben.
  3. Weiteres Repository hinzufügen klicken („z. B. das Backend zu Ihrem Frontend“) und das Backend-Repository angeben. Quellen lassen sich mischen, etwa Frontend von GitHub und Backend von Agile Git.
  4. Analysieren.
  5. Im Schritt Prüfen zeigt die Grafik die Verbindung: Frontend unter /, Backend unter /_teil/<name>, darüber der Name der Variablen, die beide verbindet (zum Beispiel NEXT_PUBLIC_API_URL), und die Datenbank mit „automatisch“.
  6. Prüfen Sie auf beiden Teil-Karten Befehle und Port und füllen Sie offene Geheimnisse aus.
  7. Installieren und starten, danach Zum Editor.

Monorepo

Liegen Frontend und Backend in einem Repository (zum Beispiel in den Ordnern frontend/ und backend/ oder unter apps/ und packages/), geben Sie nur dieses eine Repository an. Agile Vibes durchsucht übliche Ordner und legt je erkannter App einen Teil an. Der Ordner steht auf der Teil-Karte hinter dem Repository-Namen. npm-Workspaces werden erkannt; die Abhängigkeiten installiert Agile Vibes im Ordner des jeweiligen Teils.

Wie die Verbindung entsteht

Agile Vibes sucht im Frontend nach Variablen wie NEXT_PUBLIC_API_URL, VITE_API_URL, API_URL oder BACKEND_URL und berücksichtigt Rewrites in next.config. Diese Variablen bekommen Platzhalter:

  • Im Browser genutzte Variablen (etwa NEXT_PUBLIC_…, VITE_…) werden zu {{teil:backend:url}}, der öffentlichen Adresse des Backends unter /_teil/backend.
  • Serverseitig genutzte Variablen werden zu {{teil:backend:intern}}, der internen Adresse in der Sandbox.
  • Stand in der .env.example ein Pfad (etwa http://localhost:4000/api), wird der Pfad /api angehängt.
  • Umgekehrt bekommt das Backend Variablen wie FRONTEND_URL mit {{teil:web:url}}, wenn es sie nutzt.

Mehr zu Platzhaltern in Variablen, Geheimnisse und Platzhalter.

Beispiel

Next.js-Frontend in Repository A, Express-Backend mit MongoDB in Repository B:

  • Frontend (Next.js): Pfad: /; Variable: NEXT_PUBLIC_API_URL; Wert: {{teil:backend:url}}/api
  • Backend (Express): Pfad: /_teil/backend; Variable: MONGODB_URI; Wert: {{db:mongo:url}}
  • Backend (Express): Pfad: /_teil/backend; Variable: JWT_SECRET; Wert: Geheimnis (Zufallswert)

Tipps

  • Stellen Sie sicher, dass das Frontend die Backend-Adresse aus einer Variablen liest und nicht fest auf localhost zeigt.
  • Prüfen Sie, ob das Backend Routen mit einem Präfix erwartet (etwa /api). Der Platzhalter-Wert lässt sich in Einstellungen › Teile › Teil bearbeiten anpassen.
  • Cookies zwischen Frontend und Backend funktionieren, weil beide dieselbe Adresse nutzen.

Typische Fehler

  • Frontend lädt, aber Daten fehlen: Im Tab Vorschau zeigt die Fehlerleiste fehlgeschlagene Netzwerk-Aufrufe. Prüfen Sie im Tab Logs das Backend. Häufig ist der Pfad-Präfix falsch oder das Backend ist abgestürzt.
  • „Mehrere Frontends erkannt“: Das zweite Frontend läuft als weiterer Teil unter /_teil/….
  • Tarifgrenze bei Teilen: Im Tarif Free ist nur ein Teil möglich. Für Frontend und Backend brauchen Sie mindestens Start.

Häufige Fragen

Kann ich später ein weiteres Backend hinzufügen?
Ja, über die API (POST /api/v1/projekte/{id}/teile) oder mit Unterstützung unseres Supports über Hilfe & Support. Die Tarifgrenze für Teile gilt dabei.

Kann ich Änderungen in beide Repositorys zurückspielen?
Ja. Das Git-Menü zeigt jedes Repository einzeln mit Hochladen (Push) und Aktualisieren (Pull).

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.