Skip to main content
Cette page fait partie d’une compétence d’agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la documentation développeur.

​
base44 scaffold

Génère un projet local pour une application Base44 existante. Utilisez-la lorsque vous avez déjà une application Base44 (vous connaissez son ID d’application) et voulez configurer les fichiers locaux pour l’utiliser. S’exécute entièrement en mode non interactif, elle est donc sûre pour les agents et la CI.

​
Critique : quand utiliser Scaffold vs Create vs Link

ScénarioCommande
Démarrage à zéro, souhaite une NOUVELLE application Base44 + un projet à partir d’un modèlenpx base44 create
Vous avez déjà une application Base44 (par ID) et voulez des fichiers locauxnpx base44 scaffold
A un base44/config.jsonc local mais pas de .app.jsoncnpx base44 link

​
Syntaxe

npx base44 scaffold [name] [options]
Génère dans le répertoire courant.

​
Arguments et options

Argument/OptionDescriptionRequis
nameNom du projet (positionnel). Par défaut, le nom du répertoire courant.Non
--app-id <id>ID d’application Base44 existant. Se replie sur la variable d’environnement BASE44_APP_ID.Oui*
--no-skillsIgnorer l’installation des compétences d’agent IA (installées par défaut)Non
*L’ID d’application est requis : fournissez-le via --app-id ou la variable d’environnement BASE44_APP_ID. Si aucun n’est défini, la commande échoue.

​
Exemples

# 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

​
Ce que fait la commande

  1. Résout l’ID d’application depuis --app-id ou la variable d’environnement BASE44_APP_ID
  2. Applique le modèle backend-only au répertoire courant
  3. Enregistre les fichiers du projet contre l’application existante et écrit base44/.app.jsonc avec l’ID d’application
  4. Installe les compétences d’agent IA (sauf si --no-skills est passé)

​
Reprise après provisionnement (Stripe Projects / projects.dev)

scaffold est la commande à exécuter après le provisionnement d’une application Base44 via un flux Stripe Projects / projects.dev. Utilisez scaffold, pas create — l’application existe déjà, create créerait donc un doublon. Lorsque Base44 est provisionné ainsi, les identifiants sont injectés dans l’environnement sous un préfixe BASE44_PROJECTS_ (par exemple BASE44_PROJECTS_BASE44_APP_ID, BASE44_PROJECTS_BASE44_ACCESS_TOKEN, BASE44_PROJECTS_BASE44_REFRESH_TOKEN). Le CLI les normalise automatiquement en noms nus (BASE44_APP_ID, BASE44_ACCESS_TOKEN, …). En conséquence :
  • L’ID d’application est résolu automatiquement depuis BASE44_APP_ID — pas besoin du flag --app-id.
  • L’authentification est initialisée depuis BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN — pas besoin de npx base44 login interactif.
Toute l’étape post-provisionnement se résume donc à : 
npx base44 scaffold
Exécutez-la depuis le répertoire où vous voulez les fichiers du projet. Après le scaffolding, poussez les ressources avec npx base44 deploy.

​
Remarques

  • Modèle : utilise toujours le modèle backend-only (uniquement configuration Base44 — aucun front-end généré).
  • Non interactif : ne demande jamais. Ne pousse pas les entités et ne déploie pas le site. Utilisez npx base44 deploy ensuite pour pousser les ressources.
  • Application existante uniquement : contrairement à create, elle ne crée pas de nouvelle application Base44 — elle lie les fichiers locaux à l’ID d’application fourni.
  • Authentification : vous devez être authentifié (exécutez d’abord npx base44 login).
  • Le fichier .app.jsonc doit être ignoré par git (il contient votre ID d’application).
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.