​

Base44 CLI

​

⚡ SOFORTIGE HANDLUNG ERFORDERLICH — Lies das zuerst

1. Prüfe, ob base44/config.jsonc im aktuellen Verzeichnis existiert
2. Wenn JA (bestehendes Projektszenario):
   • Übergib an den base44-sdk-Skill zur Implementierung
   • Dieser Skill behandelt nur CLI-Befehle (login, deploy, entities push)
3. Wenn NEIN, entscheide zwischen zwei Initialisierungspfaden:
   • Bereitgestellte App — die Base44-App existiert bereits, weil sie gerade über einen Stripe Projects / projects.dev-Flow bereitgestellt wurde, ODER BASE44_APP_ID (oder BASE44_PROJECTS_BASE44_APP_ID) ist in der Umgebung oder in einer .env/.env.local-Datei vorhanden:
     • Führe npx base44 scaffold aus, um lokale Dateien für die bestehende App einzurichten
     • Führe NICHT npx base44 create aus — das erzeugt eine zweite, doppelte App. Siehe scaffold.md.
   • Neues Projekt — es existiert noch keine App und es wurde keine bereitgestellt:
     • Dieser Skill (base44-cli) übernimmt die Anfrage; führe den Nutzer durch npx base44 create
     • Aktiviere base44-sdk noch NICHT

​

Kritisch: Nur lokale Installation

• npx base44 <command> (npm — empfohlen)
• yarn base44 <command> (yarn)
• pnpm base44 <command> (pnpm)

​

VERPFLICHTEND: Authentifizierungsprüfung zu Sitzungsbeginn

1. Authentifizierungsstatus prüfen durch:
   npx base44 whoami
   
2. Wenn der Nutzer eingeloggt ist (Befehl erfolgreich, zeigt eine E-Mail):
   • Fahre mit der Aufgabe fort
3. Wenn der Nutzer NICHT eingeloggt ist (Befehl schlägt fehl oder zeigt einen Fehler):
   • STOPPE sofort
   • Fahre NICHT mit CLI-Operationen fort
   • Fordere den Nutzer auf, sich manuell einzuloggen mit:
     npx base44 login
     
   - Warte, bis der Nutzer bestätigt, dass er eingeloggt ist, bevor du fortfährst
   

​

Überblick

​

Wann diesen Skill vs base44-sdk verwenden

• Du ein NEUES Base44-Projekt von Grund auf erstellst
• Du ein Projekt in einem leeren Verzeichnis initialisierst
• Du lokale Dateien für eine bestehende App einrichtest, die extern bereitgestellt wurde (z. B. über einen Stripe Projects / projects.dev-Flow) → verwende scaffold
• Im Verzeichnis base44/config.jsonc fehlt
• Der Nutzer erwähnt: “neues Projekt erstellen”, “Projekt initialisieren”, “Projekt einrichten”, “neue Base44-App starten”
• Du deployst, Entitäten pushst oder dich per CLI authentifizierst
• Du mit CLI-Befehlen arbeitest (npx base44 ...)

• Du Funktionen in einem BESTEHENDEN Base44-Projekt baust
• base44/config.jsonc bereits existiert
• Du JavaScript/TypeScript-Code mit dem Base44-SDK schreibst
• Du Funktionalität, Komponenten oder Features implementierst
• Der Nutzer erwähnt: “implementieren”, “Feature bauen”, “Funktionalität hinzufügen”, “Code schreiben”

• base44-cli ist eine Voraussetzung für base44-sdk in neuen Projekten
• Wenn der Nutzer “eine App erstellen” möchte und kein Base44-Projekt existiert, verwende zuerst base44-cli
• base44-sdk setzt voraus, dass ein Base44-Projekt bereits initialisiert ist

• WENN (Nutzer erwähnt “App erstellen/bauen” ODER “Projekt machen”):
  • WENN (base44/config.jsonc existiert): → Verwende base44-sdk (Projekt existiert, Features bauen)
  • SONST WENN (App wurde extern bereitgestellt — BASE44_APP_ID/BASE44_PROJECTS_BASE44_APP_ID gesetzt oder ein Stripe Projects / projects.dev-Flow ist gerade gelaufen): → Verwende base44-cli → npx base44 scaffold (lokale Dateien für bestehende App einrichten; NICHT create)
  • SONST: → Verwende base44-cli → npx base44 create (neue Projektinitialisierung nötig)

​

Projektstruktur

my-app/
├── base44/                      # Base44 configuration (created by CLI)
│   ├── config.jsonc             # Project settings, site config
│   ├── .types/                  # Auto-generated TypeScript types (created by `types generate`)
│   │   └── types.d.ts           # Module augmentation for @base44/sdk
│   ├── entities/                # Entity schema definitions
│   │   ├── task.jsonc
│   │   └── board.jsonc
│   ├── functions/               # Backend functions (optional)
│   │   └── my-function/
│   │       └── entry.ts
│   ├── agents/                  # Agent configurations (optional)
│   │   └── support_agent.jsonc
│   └── connectors/              # OAuth connector configurations (optional)
│       └── googlecalendar.jsonc
├── src/                         # Frontend source code
│   ├── api/
│   │   └── base44Client.js      # Base44 SDK client
│   ├── pages/
│   ├── components/
│   └── main.jsx
├── index.html                   # SPA entry point
├── package.json
└── vite.config.js               # Or your framework's config

• base44/config.jsonc — Projektname, Beschreibung, Site-Build-Einstellungen
• base44/entities/*.jsonc — Datenmodell-Schemas (siehe Abschnitt Entitätsschema)
• base44/functions/*/entry.ts — Einstiegspunkt der Backend-Funktion
• base44/agents/*.jsonc — Agent-Konfigurationen (optional)
• base44/.types/types.d.ts — automatisch generierte TypeScript-Typen für Entitäten, Funktionen und Agenten (erstellt von npx base44 types generate)
• base44/connectors/*.jsonc — OAuth-Connector-Konfigurationen (optional)
• src/api/base44Client.js — vorkonfigurierter SDK-Client zur Frontend-Nutzung

{
  "name": "My App",                    // Required: project name
  "description": "App description",    // Optional: project description
  "entitiesDir": "./entities",         // Optional: default "entities"
  "functionsDir": "./functions",       // Optional: default "functions"
  "agentsDir": "./agents",             // Optional: default "agents"
  "connectorsDir": "./connectors",     // Optional: default "connectors"
  "site": {                            // Optional: site deployment config
    "installCommand": "npm install",   // Optional: install dependencies
    "buildCommand": "npm run build",   // Optional: build command
    "serveCommand": "npm run dev",     // Optional: local dev server
    "outputDirectory": "./dist"        // Optional: build output directory
  }
}

​

Installation

npm install --save-dev base44

npx base44 <command>

​

Globale Option --app-id

# Run a one-off script against a specific app
cat ./script.ts | npx base44 exec --app-id app_123

# Fetch logs for a deployed app without a local checkout
npx base44 logs --app-id app_123 --level error

• base44 create erstellt eine neue App und lehnt --app-id ab
• base44 dev läuft aus einem verknüpften lokalen Projekt und lehnt --app-id ab
• base44 deploy benötigt weiterhin ein lokales Projektverzeichnis, da es lokale Ressourcen liest

​

Verfügbare Befehle

​

Authentifizierung

​

Projektmanagement

​

Entwicklung

​

Deployment

​

Entitätsverwaltung

​

Entitäts-Schema (Schnellreferenz)

{
  "name": "EntityName",
  "type": "object",
  "properties": {
    "field_name": {
      "type": "string",
      "description": "Field description"
    }
  },
  "required": ["field_name"]
}

​

Funktionsverwaltung

​

Agenten-Verwaltung

​

Agenten-Schema (Schnellreferenz)

{
  "name": "agent_name",
  "description": "Brief description of what this agent does",
  "instructions": "Detailed instructions for the agent's behavior",
  "tool_configs": [
    // Entity tool - gives agent access to entity operations
    { "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"
}

• Agentennamen müssen dem Muster entsprechen: /^[a-z0-9_]+$/ (kleingeschrieben, alphanumerisch mit Unterstrichen, 1–100 Zeichen)
• Gültig: support_agent, order_bot
• Ungültig: Support-Agent, OrderBot

• Entity-Tools: entity_name + allowed_operations (Array aus: read, create, update, delete)
• Backend-Function-Tools: function_name + description

​

Connector-Verwaltung

​

Connector-Schema (Schnellreferenz)

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​

Auth-Konfiguration

​

Secrets-Verwaltung

​

Skript-Ausführung

​

Typ-Generierung

​

Site-Verwaltung

​

Schnellstart

1. Installiere die CLI in deinem Projekt:
   npm install --save-dev base44
   
2. Authentifiziere dich bei Base44:
   npx base44 login
   
3. Erstelle ein neues Projekt (gib IMMER Name und --path-Flag an):
   npx base44 create my-app --path .
   
4. Führe lokale Entwicklung aus:
   npx base44 dev
   
5. Baue und deploye alles:
   npm run build
   npx base44 deploy -y
   

• npx base44 entities push — Nur Entitäten pushen
• npx base44 functions deploy — Nur Funktionen deployen
• npx base44 functions delete <name> — Eine deployte Funktion löschen
• npx base44 functions list — Alle deployten Funktionen auflisten
• npx base44 functions pull — Deployte Funktionen in lokale Dateien ziehen
• npx base44 agents push — Nur Agenten pushen
• npx base44 connectors pull — Connectors von Base44 ziehen
• npx base44 connectors push — Nur Connectors pushen
• npx base44 auth pull — Auth-Konfiguration von Base44 ziehen
• npx base44 auth push — Nur Auth-Konfiguration pushen
• npx base44 site deploy -y — Nur Site deployen

​

Häufige Workflows

​

Ein neues Projekt erstellen

• Template-Auswahl — Wähle das richtige Template (backend-and-client vs backend-only)
• Korrekter Workflow — Verschiedene Templates erfordern verschiedene Einrichtungsschritte
• Häufige Fallstricke — Vermeide Ordner-Erstellungsfehler, die zu Fehlschlägen führen

​

Ein bestehendes Projekt verknüpfen

# If you have base44/config.jsonc but no .app.jsonc
npx base44 link --create --name my-app

​

Lokale Entwicklung ausführen

# Starts the Base44 backend locally
npx base44 dev

​

Alle Änderungen deployen

# Generate types (optional, for TypeScript projects)
npx base44 types generate

# Build your project first
npm run build

# Deploy everything (entities, functions, and site)
npx base44 deploy -y

​

TypeScript-Typen generieren

# Generate types from entities, functions, agents, and connectors
npx base44 types generate

​

Einzelne Ressourcen deployen

# Push only entities
npx base44 entities push

# Deploy only functions (all)
npx base44 functions deploy
# Deploy specific functions
npx base44 functions deploy my-function other-function
# Deploy and prune removed functions
npx base44 functions deploy --force

# Push only agents
npx base44 agents push

# Pull connectors from Base44
npx base44 connectors pull

# Push only connectors
npx base44 connectors push

# Deploy only site
npx base44 site deploy -y

​

Das Dashboard öffnen

# Open app dashboard in browser
npx base44 dashboard

​

Authentifizierung

​

Fehlerbehebung