> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. Läuft vollständig nicht-in...

<Warning>
  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](/developers).
</Warning>

# 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.

## Kritisch: Wann Scaffold vs Create vs Link verwenden

| Szenario                                                                     | Befehl                |
| ---------------------------------------------------------------------------- | --------------------- |
| Von vorne beginnen, willst eine NEUE Base44-App + Projekt aus einem Template | `npx base44 create`   |
| Du hast bereits eine Base44-App (nach ID) und willst lokale Dateien dafür    | `npx base44 scaffold` |
| Lokale `base44/config.jsonc` vorhanden, aber kein `.app.jsonc`               | `npx base44 link`     |

## Syntax

```bash theme={null}
npx base44 scaffold [name] [options]
```

Scaffoldet in das **aktuelle Verzeichnis**.

## Argumente & Optionen

| Argument/Option | Beschreibung                                                                            | Erforderlich |
| --------------- | --------------------------------------------------------------------------------------- | ------------ |
| `name`          | Projektname (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-skills`   | Installation 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

```bash theme={null}
# 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:

```bash theme={null}
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).

<Note>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>