> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 in...

<Warning>
  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](/developers).
</Warning>

# 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.

## Critico: quando usare Scaffold vs Create vs Link

| Scenario                                                              | Comando               |
| --------------------------------------------------------------------- | --------------------- |
| Partenza da zero, vuoi una NUOVA app Base44 + progetto da un template | `npx base44 create`   |
| Hai già un'app Base44 (per ID) e vuoi i file locali per essa          | `npx base44 scaffold` |
| Hai un `base44/config.jsonc` locale ma nessun `.app.jsonc`            | `npx base44 link`     |

## Sintassi

```bash theme={null}
npx base44 scaffold [name] [options]
```

Crea la struttura nella **directory corrente**.

## Argomenti e opzioni

| Argomento/Opzione | Descrizione                                                                                             | Obbligatorio |
| ----------------- | ------------------------------------------------------------------------------------------------------- | ------------ |
| `name`            | Nome 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-skills`     | Salta 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

```bash theme={null}
# 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:

```bash theme={null}
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).

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>