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

> Crea un nuovo progetto Base44 da un template. Questo comando è indipendente dal framework e può sia costruire un progetto completo sia aggiungere la configurazione di Base44 a un progetto esistente.

<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 create

Crea un nuovo progetto Base44 da un template. Questo comando è indipendente dal framework e può sia costruire un progetto completo sia aggiungere la configurazione di Base44 a un progetto esistente.

## Critico: modalità non interattiva richiesta

Fornisci SEMPRE sia il nome del progetto SIA il flag `--path`. Senza entrambi, il comando apre una TUI interattiva che gli agenti non possono usare correttamente.

SBAGLIATO: `npx base44 create`
SBAGLIATO: `npx base44 create my-app`
CORRETTO: `npx base44 create my-app -p ./my-app`

## Sintassi

```bash theme={null}
npx base44 create [name] --path <path> [options]
```

## Argomenti e opzioni

| Argomento/Opzione     | Descrizione                                                                                              | Obbligatorio |
| --------------------- | -------------------------------------------------------------------------------------------------------- | ------------ |
| `name`                | Nome del progetto (argomento posizionale)                                                                | Sì\*         |
| `-p, --path <path>`   | Percorso dove creare il progetto                                                                         | Sì\*         |
| `-t, --template <id>` | ID del template (vedi template qui sotto)                                                                | No           |
| `--deploy`            | Costruisce e distribuisce il sito (include il push delle entità)                                         | No           |
| `--no-skills`         | Salta l'installazione delle skill per agenti IA (le skill vengono aggiunte per impostazione predefinita) | No           |

\*Obbligatorio per la modalità non interattiva. Sia `name` sia `--path` devono essere forniti insieme.

## Selezione del template (CRITICO - Scegli in modo appropriato)

**DEVI selezionare il template più appropriato in base ai requisiti dell'utente:**

| ID template          | Quando usarlo                                                                                       | Scenari di esempio                                                              |
| -------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `backend-and-client` | Creare una NUOVA app web full-stack da zero                                                         | "Crea un'app di attività", "Costruiscimi una dashboard", "Crea un'app SaaS"     |
| `backend-only`       | Aggiungere Base44 a un progetto ESISTENTE O usare un framework diverso (Next.js, Vue, Svelte, ecc.) | "Aggiungi Base44 al mio progetto", "Voglio usare Next.js", "Ho già un frontend" |

**Scelta predefinita:** quando l'utente chiede di "creare un'app" o "costruire un progetto" senza specificare un framework particolare, usa `backend-and-client` per fornire un'applicazione completa e pronta per la produzione con Vite + React + Tailwind.

## Il flag `--path`

* **Per il template `backend-and-client` (nuovi progetti):** usa un percorso di sottocartella nuovo
  ```bash theme={null}
  npx base44 create my-app -p ./my-app -t backend-and-client
  ```
* **Per il template `backend-only` (progetti esistenti):** usa `-p .` nella directory corrente
  ```bash theme={null}
  npx base44 create my-app -p .
  ```

## Flusso di lavoro: usare `backend-only` con framework esterni

**CRITICO: la cartella del progetto DEVE esistere PRIMA di eseguire `base44 create` con `backend-only`**

Il template `backend-only` aggiunge solo file di configurazione Base44 - NON crea un frontend. Se hai bisogno di un frontend con un framework specifico:

```bash theme={null}
# Step 1: Initialize the frontend project FIRST
npm create vite@latest my-app -- --template react  # or vue, svelte, etc.
# OR: npx create-next-app@latest my-app
# OR: any other framework's init command

# Step 2: Navigate into the created folder
cd my-app

# Step 3: Install Base44 CLI
npm install --save-dev base44

# Step 4: Add Base44 configuration
npx base44 create my-app -p .
```

**ATTENZIONE:** NON:

* Creare una cartella vuota manualmente, e poi cercare di eseguire `npx create vite` al suo interno (fallirà - la cartella esiste)
* Eseguire `base44 create` con `backend-only` aspettandoti che crei un frontend (non lo farà)

**FALLO:**

* Esegui prima il comando di init del framework esterno (creerà la propria cartella)
* Poi esegui `base44 create` dentro quella cartella con `-p .`

## Esempi

```bash theme={null}
# RECOMMENDED: Create full-stack project (for new apps)
npx base44 create my-app -p ./my-app -t backend-and-client

# Create full-stack and deploy in one step
npx base44 create my-app -p ./my-app -t backend-and-client --deploy

# Add Base44 to EXISTING project (must be inside the project folder)
npx base44 create my-app -p .

# Add Base44 to existing project and deploy
npx base44 create my-app -p . --deploy

# Create without adding AI agent skills
npx base44 create my-app -p . --no-skills
```

## Cosa fa

1. Applica il template selezionato al percorso di destinazione
2. Crea una cartella `base44/` con file di configurazione
3. Registra il progetto con il backend di Base44
4. Crea `base44/.app.jsonc` con l'ID dell'app
5. Se viene usato `--deploy`:
   * Fa il push di qualsiasi entità definita in `base44/entities/`
   * Esegue i comandi di install e build (per i template con frontend)
   * Distribuisce il sito sull'hosting di Base44

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