Passer au contenu principal
La commande create de la CLI Base44 crée de nouveaux projets avec tous les fichiers et configurations nécessaires. Cet article décrit la structure des projets backend Base44 et explique ce que fait chaque fichier et répertoire.

​
Structure du projet backend

Lorsque vous créez un projet Base44 uniquement backend, la CLI génère cette structure minimale :
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
Au fur et à mesure que vous développez votre projet, vous ajoutez des fichiers pour vos ressources telles que les entités, les fonctions, les agents, les connecteurs et la configuration d’auth :
<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
Les fonctions ne nécessitent qu’un fichier entry.ts ou entry.js. Vous pouvez éventuellement ajouter function.jsonc pour des configurations avancées comme des noms personnalisés ou des automatisations. Consultez Fonctions backend pour plus de détails.

​
base44/

Contient toute la configuration backend Base44 et les définitions des ressources.

​
config.jsonc

Définit la configuration de votre projet, y compris les chemins vers les entités, les fonctions, les agents, les connecteurs, la configuration d’auth et les paramètres d’hébergement du site pour les projets full-stack. La CLI le crée juste avec le nom de votre projet, et vous pouvez ajouter plus de configuration selon vos besoins. Votre projet nécessite un fichier config.jsonc (ou config.json) dans le répertoire 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
  },
}
PropriétéDescriptionPar défaut
nameNom du projet (requis)—
descriptionDescription du projet—
entitiesDirChemin vers le répertoire des entités./entities
functionsDirChemin vers le répertoire des fonctions./functions
agentsDirChemin vers le répertoire des agents./agents
connectorsDirChemin vers le répertoire des connecteurs./connectors
authDirChemin vers le répertoire de configuration d’auth./auth
site.outputDirectoryOù se trouvent les fichiers compilés de votre site (requis pour le déploiement du site)—
site.buildCommandUtilisé uniquement pendant base44 create pour le déploiement automatisé—
site.installCommandUtilisé uniquement pendant base44 create pour le déploiement automatisé—
site.serveCommandRéférence uniquement. Non utilisé actuellement par la CLI—
Les propriétés buildCommand, installCommand et serveCommand sont incluses automatiquement lorsque vous créez un projet à partir du modèle full-stack. Elles sont utilisées uniquement pendant le flux initial base44 create pour le déploiement automatisé. Vous n’avez pas besoin de spécifier ou de modifier ces propriétés après la création du projet. Lors du déploiement ultérieur de votre site avec site deploy, seul outputDirectory est utilisé.

​
.app.jsonc

Lie votre projet local à votre application Base44. Ce fichier est créé automatiquement par la CLI lorsque vous créez ou liez un projet. 
// 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",
}
Le fichier .app.jsonc ne doit pas être validé dans le contrôle de version. La CLI crée automatiquement un fichier .gitignore qui exclut ce fichier.

​
.types/types.d.ts

Définitions de types TypeScript générées pour vos entités, fonctions, agents et connecteurs. Créées en exécutant base44 types generate. Ce fichier fournit l’autocomplétion et la sécurité des types lors de l’utilisation du SDK dans des projets TypeScript. Consultez Types dynamiques pour plus de détails.

​
agents/

Répertoire contenant les configurations d’agents IA. Chaque agent est défini dans un fichier .json ou .jsonc séparé.

​
auth/

Répertoire contenant la configuration d’authentification de votre application. Contient un seul fichier config.jsonc qui définit quelles méthodes de connexion sont disponibles pour vos utilisateurs finaux. Récupérez la configuration actuelle depuis Base44 avec auth pull.

​
connectors/

Répertoire contenant les configurations de connecteurs OAuth. Chaque connecteur est défini dans un fichier .json ou .jsonc séparé nommé d’après le type d’intégration comme slack.jsonc ou googlecalendar.jsonc.

​
entities/

Répertoire contenant les définitions de schémas d’entités. Chaque entité est définie dans un fichier .json ou .jsonc séparé. Créez ce répertoire lorsque vous êtes prêt à définir votre première entité.

​
functions/

Répertoire contenant les fonctions backend serverless. Chaque fonction nécessite son propre sous-répertoire avec un fichier de code entry.ts ou entry.js. La CLI utilise le chemin du répertoire relatif à la racine des fonctions comme nom de fonction. Par exemple, functions/sendEmail/entry.ts crée une fonction nommée sendEmail. Vous pouvez éventuellement ajouter un fichier de configuration function.jsonc pour personnaliser le nom de la fonction ou ajouter des automatisations.
functions
<function-name>
entry.ts
function.jsonc

​
.gitignore

Empêche les fichiers d’être validés dans le contrôle de version. Votre projet commence avec ce fichier pour empêcher la validation de .app.jsonc.

​
Dossiers de skills d’agent IA

Lorsque vous créez un projet avec base44 create, les skills d’agent IA sont installées automatiquement. Elles apparaissent dans des dossiers spécifiques à l’agent comme .claude/skills/, .cursor/skills/ ou similaires, selon l’assistant de codage IA que vous utilisez. Ces dossiers aident votre agent de codage à comprendre comment travailler avec Base44 et peuvent être validés en toute sécurité dans le contrôle de version.

​
Voir aussi

Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.