Skip to main content
Questa pagina fa parte di una skill per agenti IA di programmazione ed è scritta per gli agenti, non per gli umani. Per la documentazione Base44 leggibile dagli umani, consulta la documentazione per sviluppatori.

​
base44 scaffold

Crea la struttura di un progetto locale per un’app Base44 esistente. Usa questo quando hai già un’app Base44 (ne conosci l’app ID) e vuoi configurare i file di progetto locali per lavorarci. Viene eseguito completamente in modalità non interattiva, quindi è sicuro per agenti e CI.
ScenarioComando
Partenza da zero, vuoi una NUOVA app Base44 + progetto da un templatenpx base44 create
Hai già un’app Base44 (per ID) e vuoi i file locali per essanpx base44 scaffold
Hai un base44/config.jsonc locale ma nessun .app.jsoncnpx base44 link

​
Sintassi

npx base44 scaffold [name] [options]
Crea la struttura nella directory corrente.

​
Argomenti e opzioni

Argomento/OpzioneDescrizioneObbligatorio
nameNome del progetto (posizionale). Predefinito al nome della directory corrente.No
--app-id <id>App ID Base44 esistente. Fa fallback alla variabile d’ambiente BASE44_APP_ID.Sì*
--no-skillsSalta l’installazione delle skill per agenti IA (le skill sono installate per impostazione predefinita)No
*L’app ID è obbligatorio: fornisci tramite --app-id o la variabile d’ambiente BASE44_APP_ID. Se nessuno dei due è impostato, il comando fallisce.

​
Esempi

# 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

​
Cosa fa

  1. Risolve l’app ID da --app-id o dalla variabile d’ambiente BASE44_APP_ID
  2. Applica il template backend-only alla directory corrente
  3. Registra i file del progetto contro l’app esistente e scrive base44/.app.jsonc con l’app ID
  4. Installa le skill per agenti IA (a meno che non venga passato --no-skills)

​
Passaggio dal provisioning (Stripe Projects / projects.dev)

scaffold è il comando da eseguire dopo che un’app Base44 è stata provisionata attraverso un flusso Stripe Projects / projects.dev. Usa scaffold, non create — l’app esiste già, quindi create creerebbe un duplicato. Quando Base44 viene provisionato in quel modo, le credenziali vengono iniettate nell’ambiente sotto il prefisso BASE44_PROJECTS_ (ad es. BASE44_PROJECTS_BASE44_APP_ID, BASE44_PROJECTS_BASE44_ACCESS_TOKEN, BASE44_PROJECTS_BASE44_REFRESH_TOKEN). La CLI normalizza automaticamente questi ai nomi semplici che usa (BASE44_APP_ID, BASE44_ACCESS_TOKEN, …). Di conseguenza:
  • App ID viene risolto automaticamente da BASE44_APP_ID — nessun flag --app-id necessario.
  • Autenticazione è inizializzata da BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN — nessun npx base44 login interattivo necessario.
Quindi l’intero passaggio post-provisioning è semplicemente: 
npx base44 scaffold
Eseguilo dalla directory in cui vuoi i file del progetto. Dopo lo scaffolding, invia le risorse con npx base44 deploy.

​
Note

  • Template: usa sempre il template backend-only (solo configurazione Base44 — nessun frontend viene generato).
  • Non interattivo: non chiede mai. Non fa il push delle entità né distribuisce il sito. Usa npx base44 deploy dopo per inviare le risorse.
  • Solo app esistenti: a differenza di create, questo non crea una nuova app Base44 — collega i file locali all’app ID che fornisci.
  • Autenticazione: richiede che tu sia autenticato (esegui prima npx base44 login).
  • Il file .app.jsonc dovrebbe essere ignorato da git (contiene l’app ID).
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.