​

CLI Base44

​

⚡ ACTION IMMÉDIATE REQUISE - À lire en premier

1. Vérifier si base44/config.jsonc existe dans le répertoire courant
2. Si OUI (scénario projet existant) :
   • Transférer à la compétence base44-sdk pour l’implémentation
   • Cette compétence ne gère que les commandes CLI (login, deploy, entities push)
3. Si NON, choisir entre deux chemins d’initialisation :
   • Application provisionnée — l’application Base44 existe déjà car elle vient d’être provisionnée via un flux Stripe Projects / projects.dev, OU BASE44_APP_ID (ou BASE44_PROJECTS_BASE44_APP_ID) est présent dans l’environnement ou un fichier .env/.env.local :
     • Exécutez npx base44 scaffold pour configurer les fichiers locaux de cette application existante
     • N’exécutez PAS npx base44 create — cela crée une seconde application en double. Consultez scaffold.md.
   • Nouveau projet — aucune application n’existe encore et aucune n’a été provisionnée :
     • Cette compétence (base44-cli) traite la requête ; guidez l’utilisateur avec npx base44 create
     • N’activez PAS encore base44-sdk

​

Critique : installation locale uniquement

• npx base44 <command> (npm - recommandé)
• yarn base44 <command> (yarn)
• pnpm base44 <command> (pnpm)

​

OBLIGATOIRE : vérification d’authentification au démarrage de session

1. Vérifier le statut d’authentification en exécutant :
   npx base44 whoami
   
2. Si l’utilisateur est connecté (la commande réussit et affiche un e-mail) :
   • Continuez avec la tâche demandée
3. Si l’utilisateur n’est PAS connecté (la commande échoue ou affiche une erreur) :
   • ARRÊTEZ immédiatement
   • N’effectuez AUCUNE opération CLI
   • Demandez à l’utilisateur de se connecter manuellement en exécutant :
     npx base44 login
     
   - Attendez que l'utilisateur confirme sa connexion avant de continuer
   

​

Aperçu

​

Quand utiliser cette compétence par rapport à base44-sdk

• Créer un NOUVEAU projet Base44 à partir de zéro
• Initialiser un projet dans un répertoire vide
• Configurer les fichiers locaux d’une application existante provisionnée en externe (par exemple, via un flux Stripe Projects / projects.dev) → utilisez scaffold
• Le répertoire ne contient pas base44/config.jsonc
• L’utilisateur mentionne : « créer un nouveau projet », « initialiser un projet », « configurer un projet », « démarrer une nouvelle application Base44 »
• Déployer, pousser des entités ou s’authentifier via le CLI
• Travailler avec des commandes CLI (npx base44 ...)

• Construire des fonctionnalités dans un projet Base44 EXISTANT
• base44/config.jsonc existe déjà
• Écrire du code JavaScript/TypeScript utilisant le SDK Base44
• Implémenter des fonctionnalités, composants ou features
• L’utilisateur mentionne : « implémenter », « construire une fonctionnalité », « ajouter une fonctionnalité », « écrire du code »

• base44-cli est un prérequis de base44-sdk pour les nouveaux projets
• Si l’utilisateur veut « créer une application » et qu’aucun projet Base44 n’existe, utilisez d’abord base44-cli
• base44-sdk suppose qu’un projet Base44 est déjà initialisé

• SI (l’utilisateur mentionne « créer/construire une application » OU « faire un projet ») :
  • SI (base44/config.jsonc existe) : → Utilisez base44-sdk (le projet existe, construisez des fonctionnalités)
  • SINON SI (l’application a été provisionnée en externe — BASE44_APP_ID/BASE44_PROJECTS_BASE44_APP_ID défini, ou un flux Stripe Projects / projects.dev vient de s’exécuter) : → Utilisez base44-cli → npx base44 scaffold (configurez les fichiers locaux pour l’application existante ; ne faites PAS create)
  • SINON : → Utilisez base44-cli → npx base44 create (initialisation d’un nouveau projet nécessaire)

​

Structure du projet

my-app/
├── base44/                      # Configuration Base44 (créée par le CLI)
│   ├── config.jsonc             # Paramètres du projet, config du site
│   ├── .types/                  # Types TypeScript auto-générés (créés par `types generate`)
│   │   └── types.d.ts           # Augmentation de module pour @base44/sdk
│   ├── entities/                # Définitions de schémas d'entités
│   │   ├── task.jsonc
│   │   └── board.jsonc
│   ├── functions/               # Fonctions backend (facultatif)
│   │   └── my-function/
│   │       └── entry.ts
│   ├── agents/                  # Configurations d'agents (facultatif)
│   │   └── support_agent.jsonc
│   └── connectors/              # Configurations de connecteurs OAuth (facultatif)
│       └── googlecalendar.jsonc
├── src/                         # Code source du front-end
│   ├── api/
│   │   └── base44Client.js      # Client SDK Base44
│   ├── pages/
│   ├── components/
│   └── main.jsx
├── index.html                   # Point d'entrée SPA
├── package.json
└── vite.config.js               # Ou la config de votre framework

• base44/config.jsonc - Nom du projet, description, paramètres de build du site
• base44/entities/*.jsonc - Schémas de modèle de données (voir la section Schéma d’entité)
• base44/functions/*/entry.ts - Point d’entrée d’une fonction backend
• base44/agents/*.jsonc - Configurations d’agents (facultatif)
• base44/.types/types.d.ts - Types TypeScript auto-générés pour les entités, fonctions et agents (créés par npx base44 types generate)
• base44/connectors/*.jsonc - Configurations de connecteurs OAuth (facultatif)
• src/api/base44Client.js - Client SDK préconfiguré pour l’usage front-end

{
  "name": "My App",                    // Requis : nom du projet
  "description": "App description",    // Facultatif : description du projet
  "entitiesDir": "./entities",         // Facultatif : par défaut "entities"
  "functionsDir": "./functions",       // Facultatif : par défaut "functions"
  "agentsDir": "./agents",             // Facultatif : par défaut "agents"
  "connectorsDir": "./connectors",     // Facultatif : par défaut "connectors"
  "site": {                            // Facultatif : config de déploiement du site
    "installCommand": "npm install",   // Facultatif : installer les dépendances
    "buildCommand": "npm run build",   // Facultatif : commande de build
    "serveCommand": "npm run dev",     // Facultatif : serveur de dev local
    "outputDirectory": "./dist"        // Facultatif : répertoire de sortie du build
  }
}

​

Installation

npm install --save-dev base44

npx base44 <command>

​

Option globale --app-id

# Exécuter un script ponctuel sur une application spécifique
cat ./script.ts | npx base44 exec --app-id app_123

# Récupérer les journaux d'une application déployée sans checkout local
npx base44 logs --app-id app_123 --level error

• base44 create crée une nouvelle application, elle rejette donc --app-id
• base44 dev s’exécute depuis un projet local lié, elle rejette donc --app-id
• base44 deploy nécessite toujours un répertoire de projet local car elle lit les ressources locales

​

Commandes disponibles

​

Authentification

​

Gestion de projet

​

Développement

​

Déploiement

​

Gestion des entités

​

Schéma d’entité (référence rapide)

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

​

Gestion des fonctions

​

Gestion des agents

​

Schéma d’agent (référence rapide)

{
  "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?"
}

• Les noms d’agents doivent correspondre au motif : /^[a-z0-9_]+$/ (alphanumérique en minuscules avec underscores, 1 à 100 caractères)
• Valides : support_agent, order_bot
• Invalides : Support-Agent, OrderBot

• Outils d’entité : entity_name + allowed_operations (tableau parmi : read, create, update, delete)
• Outils de fonction backend : function_name + description

​

Gestion des connecteurs

​

Schéma de connecteur (référence rapide)

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

​

Configuration d’authentification

​

Gestion des secrets

​

Exécution de scripts

​

Génération de types

​

Gestion du site

​

Démarrage rapide

1. Installez le CLI dans votre projet :
   npm install --save-dev base44
   
2. Authentifiez-vous auprès de Base44 :
   npx base44 login
   
3. Créez un nouveau projet (fournissez TOUJOURS un nom et le flag --path) :
   npx base44 create my-app --path .
   
4. Lancez le développement local :
   npx base44 dev
   
5. Buildez et déployez tout :
   npm run build
   npx base44 deploy -y
   

• npx base44 entities push - Pousser uniquement les entités
• npx base44 functions deploy - Déployer uniquement les fonctions
• npx base44 functions delete <name> - Supprimer une fonction déployée
• npx base44 functions list - Lister toutes les fonctions déployées
• npx base44 functions pull - Récupérer les fonctions déployées vers des fichiers locaux
• npx base44 agents push - Pousser uniquement les agents
• npx base44 connectors pull - Récupérer les connecteurs de Base44
• npx base44 connectors push - Pousser uniquement les connecteurs
• npx base44 auth pull - Récupérer la config d’authentification de Base44
• npx base44 auth push - Pousser uniquement la config d’authentification
• npx base44 site deploy -y - Déployer uniquement le site

​

Workflows courants

​

Créer un nouveau projet

• Sélection de modèle - Choisir le bon modèle (backend-and-client vs backend-only)
• Workflow correct - Chaque modèle requiert des étapes de configuration différentes
• Pièges courants - Éviter les erreurs de création de dossier qui causent des échecs

​

Lier un projet existant

# Si vous avez base44/config.jsonc mais pas .app.jsonc
npx base44 link --create --name my-app

​

Lancer le développement local

# Démarre le backend Base44 en local
npx base44 dev

​

Déployer tous les changements

# Générer les types (facultatif, pour les projets TypeScript)
npx base44 types generate

# Buildez d'abord votre projet
npm run build

# Déployez tout (entités, fonctions et site)
npx base44 deploy -y

​

Générer les types TypeScript

# Générer les types à partir des entités, fonctions, agents et connecteurs
npx base44 types generate

​

Déployer des ressources individuelles

# Pousser uniquement les entités
npx base44 entities push

# Déployer uniquement les fonctions (toutes)
npx base44 functions deploy
# Déployer des fonctions spécifiques
npx base44 functions deploy my-function other-function
# Déployer et élaguer les fonctions supprimées
npx base44 functions deploy --force

# Pousser uniquement les agents
npx base44 agents push

# Récupérer les connecteurs de Base44
npx base44 connectors pull

# Pousser uniquement les connecteurs
npx base44 connectors push

# Déployer uniquement le site
npx base44 site deploy -y

​

Ouvrir le tableau de bord

# Ouvrir le tableau de bord de l'application dans le navigateur
npx base44 dashboard

​

Authentification

​

Dépannage