Skip to main content
Diese Seite ist Teil eines KI-Coding-Agent-Skills und für Agenten geschrieben, nicht für Menschen. Für die menschenlesbare Base44-Dokumentation siehe die Entwicklerdokumentation.

​
base44 scaffold

Scaffoldet ein lokales Projekt für eine bestehende Base44-App. Verwende dies, wenn du bereits eine Base44-App hast (du kennst ihre App-ID) und die lokalen Projektdateien einrichten willst, um mit ihr zu arbeiten. Läuft vollständig nicht-interaktiv, sodass es für Agenten und CI sicher ist.
SzenarioBefehl
Von vorne beginnen, willst eine NEUE Base44-App + Projekt aus einem Templatenpx base44 create
Du hast bereits eine Base44-App (nach ID) und willst lokale Dateien dafürnpx base44 scaffold
Lokale base44/config.jsonc vorhanden, aber kein .app.jsoncnpx base44 link

​
Syntax

npx base44 scaffold [name] [options]
Scaffoldet in das aktuelle Verzeichnis.

​
Argumente & Optionen

Argument/OptionBeschreibungErforderlich
nameProjektname (positional). Standardwert ist der Name des aktuellen Verzeichnisses.Nein
--app-id <id>Bestehende Base44-App-ID. Fällt auf die Umgebungsvariable BASE44_APP_ID zurück.Ja*
--no-skillsInstallation der KI-Agent-Skills überspringen (Skills werden standardmäßig installiert)Nein
*Die App-ID ist erforderlich: gib sie über --app-id oder die Umgebungsvariable BASE44_APP_ID an. Wenn keins gesetzt ist, schlägt der Befehl fehl.

​
Beispiele

# Scaffold the current directory for an existing app
npx base44 scaffold --app-id app_123

# Scaffold the current directory with an explicit project name
npx base44 scaffold my-app --app-id app_123

# Provide the app ID via environment variable instead of the flag
BASE44_APP_ID=app_123 npx base44 scaffold

# Scaffold without installing AI agent skills
npx base44 scaffold --app-id app_123 --no-skills

​
Was der Befehl tut

  1. Löst die App-ID aus --app-id oder der Umgebungsvariable BASE44_APP_ID auf
  2. Wendet das backend-only-Template auf das aktuelle Verzeichnis an
  3. Registriert die Projektdateien gegen die bestehende App und schreibt base44/.app.jsonc mit der App-ID
  4. Installiert KI-Agent-Skills (außer bei --no-skills)

​
Provisioning-Übergabe (Stripe Projects / projects.dev)

scaffold ist der Befehl, den du nach der Bereitstellung einer Base44-App über einen Stripe Projects / projects.dev-Flow ausführst. Verwende scaffold, nicht create — die App existiert bereits, sodass create ein Duplikat erstellen würde. Wenn Base44 auf diesem Weg bereitgestellt wird, werden die Anmeldedaten mit dem Präfix BASE44_PROJECTS_ in die Umgebung injiziert (z. B. BASE44_PROJECTS_BASE44_APP_ID, BASE44_PROJECTS_BASE44_ACCESS_TOKEN, BASE44_PROJECTS_BASE44_REFRESH_TOKEN). Die CLI normalisiert diese automatisch auf die verwendeten Bare-Namen (BASE44_APP_ID, BASE44_ACCESS_TOKEN, …). Als Ergebnis:
  • Die App-ID wird automatisch aus BASE44_APP_ID aufgelöst — kein --app-id-Flag nötig.
  • Die Authentifizierung wird aus BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN bezogen — kein interaktives npx base44 login nötig.
Der gesamte Post-Provisioning-Schritt ist also nur: 
npx base44 scaffold
Führe es aus dem Verzeichnis aus, in dem du die Projektdateien willst. Nach dem Scaffolding pushe Ressourcen mit npx base44 deploy.

​
Hinweise

  • Template: Verwendet immer das backend-only-Template (nur Base44-Konfiguration — kein Frontend wird generiert).
  • Nicht-interaktiv: Fragt nie nach. Es pusht keine Entitäten und deployt die Site nicht. Verwende danach npx base44 deploy, um Ressourcen zu pushen.
  • Nur bestehende App: Anders als create erstellt dies keine neue Base44-App — es verknüpft lokale Dateien mit der App-ID, die du angibst.
  • Authentifizierung: Erfordert, dass du authentifiziert bist (führe zuerst npx base44 login aus).
  • Die Datei .app.jsonc sollte in .gitignore stehen (sie enthält deine App-ID).
Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.