Zum Hauptinhalt springen
Der create-Befehl der Base44 CLI erstellt neue Projekte mit allen erforderlichen Dateien und Konfigurationen. Dieser Artikel beschreibt die Base44-Backend-Projektstruktur und erklärt, was jede Datei und jedes Verzeichnis macht.

​
Backend-Projektstruktur

Wenn du ein Backend-only-Base44-Projekt erstellst, generiert die CLI diese minimale Struktur:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
Während du dein Projekt entwickelst, fügst du Dateien für deine Ressourcen hinzu, etwa Entitäten, Funktionen, Agenten, Connectors und Auth-Konfiguration:
<your-project-name>
base44
.app.jsonc
config.jsonc
.types
types.d.ts
agents
<agent-name>.jsonc
auth
config.jsonc
connectors
<connector-type>.jsonc
entities
<entity-name>.jsonc
functions
<function-name>
entry.ts
function.jsonc
.gitignore
Funktionen benötigen nur eine entry.ts- oder entry.js-Datei. Du kannst optional function.jsonc für erweiterte Konfigurationen wie eigene Namen oder Automationen hinzufügen. Siehe Backend-Funktionen für Details.

​
base44/

Enthält die gesamte Base44-Backend-Konfiguration und Ressourcendefinitionen.

​
config.jsonc

Definiert deine Projektkonfiguration, einschließlich Pfaden zu Entitäten, Funktionen, Agenten, Connectors, Auth-Konfiguration und Site-Hosting-Einstellungen für Full-Stack-Projekte. Die CLI erstellt dies nur mit deinem Projektnamen, und du kannst nach Bedarf weitere Konfiguration hinzufügen. Dein Projekt benötigt eine config.jsonc- (oder config.json-) Datei im Verzeichnis base44/: 
// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",

  // Directory paths (relative to config file)
  "entitiesDir": "./entities",
  "functionsDir": "./functions",
  "agentsDir": "./agents",
  "connectorsDir": "./connectors",
  "authDir": "./auth",

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - where your built files are located
  },
}
EigenschaftBeschreibungStandard
nameProjektname (erforderlich)—
descriptionProjektbeschreibung—
entitiesDirPfad zum Verzeichnis Entitäten./entities
functionsDirPfad zum Verzeichnis Funktionen./functions
agentsDirPfad zum Verzeichnis Agenten./agents
connectorsDirPfad zum Verzeichnis Connectors./connectors
authDirPfad zur Auth-Konfiguration./auth
site.outputDirectoryWo sich deine gebauten Site-Dateien befinden (erforderlich für Site-Deployment)—
site.buildCommandWird nur während base44 create für automatisiertes Deployment verwendet—
site.installCommandWird nur während base44 create für automatisiertes Deployment verwendet—
site.serveCommandNur Referenz. Wird derzeit nicht von der CLI verwendet—
Die Eigenschaften buildCommand, installCommand und serveCommand werden automatisch eingefügt, wenn du ein Projekt aus der Full-Stack-Vorlage erstellst. Sie werden nur während des anfänglichen base44 create-Flows für automatisiertes Deployment verwendet. Du musst diese Eigenschaften nach der Projekterstellung nicht angeben oder ändern. Beim späteren Deployen deiner Site mit site deploy wird nur outputDirectory verwendet.

​
.app.jsonc

Verknüpft dein lokales Projekt mit deiner Base44-App. Diese Datei wird automatisch von der CLI erstellt, wenn du ein Projekt erstellst oder verknüpfst. 
// Base44 App Configuration
// This file links your local project to your Base44 app.
// Do not commit this file to version control.
{
  "id": "your-app-id",
}
Die Datei .app.jsonc sollte nicht in die Versionskontrolle eingecheckt werden. Die CLI erstellt automatisch eine .gitignore-Datei, die diese Datei ausschließt.

​
.types/types.d.ts

Generierte TypeScript-Typdefinitionen für deine Entitäten, Funktionen, Agenten und Connectors. Wird durch Ausführen von base44 types generate erstellt. Diese Datei bietet Autovervollständigung und Typsicherheit, wenn du das SDK in TypeScript-Projekten verwendest. Siehe Dynamische Typen für weitere Details.

​
agents/

Verzeichnis, das KI-Agenten-Konfigurationen enthält. Jeder Agent wird in einer separaten .json- oder .jsonc-Datei definiert.

​
auth/

Verzeichnis, das die Authentifizierungskonfiguration deiner App enthält. Enthält eine einzelne config.jsonc-Datei, die definiert, welche Login-Methoden deinen Endbenutzern zur Verfügung stehen. Hole die aktuelle Konfiguration mit auth pull aus Base44.

​
connectors/

Verzeichnis, das OAuth-Connector-Konfigurationen enthält. Jeder Connector wird in einer separaten .json- oder .jsonc-Datei definiert, die nach dem Integrationstyp benannt ist, etwa slack.jsonc oder googlecalendar.jsonc.

​
entities/

Verzeichnis, das Entity-Schema-Definitionen enthält. Jede Entität wird in einer separaten .json- oder .jsonc-Datei definiert. Erstelle dieses Verzeichnis, wenn du bereit bist, deine erste Entität zu definieren.

​
functions/

Verzeichnis, das serverlose Backend-Funktionen enthält. Jede Funktion benötigt ihr eigenes Unterverzeichnis mit einer entry.ts- oder entry.js-Codedatei. Die CLI verwendet den Verzeichnispfad relativ zum Funktions-Stammverzeichnis als Funktionsnamen. Zum Beispiel erstellt functions/sendEmail/entry.ts eine Funktion namens sendEmail. Du kannst optional eine function.jsonc-Konfigurationsdatei hinzufügen, um den Funktionsnamen anzupassen oder Automationen hinzuzufügen.
functions
<function-name>
entry.ts
function.jsonc

​
.gitignore

Verhindert, dass Dateien in die Versionskontrolle eingecheckt werden. Dein Projekt startet mit dieser Datei, um zu verhindern, dass .app.jsonc eingecheckt wird.

​
KI-Agenten-Skills-Ordner

Wenn du ein Projekt mit base44 create erstellst, werden KI-Agenten-Skills automatisch installiert. Diese erscheinen in agentenspezifischen Ordnern wie .claude/skills/, .cursor/skills/ oder ähnlichen, je nachdem, welchen KI-Coding-Assistenten du verwendest. Diese Ordner helfen deinem Coding-Agenten zu verstehen, wie er mit Base44 arbeitet, und können bedenkenlos in die Versionskontrolle eingecheckt werden.

​
Siehe auch

Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.