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

# Sviluppa in locale in Manus Studio

> Crea siti web, app web, app mobile e giochi in una cartella sul tuo computer con Manus Studio. Scegli i servizi gestiti da Manus o un semplice progetto locale.

## Che cos'è

**Sviluppa in locale** (**Build locally**) consente a Manus di creare un sito web, un'app web, un'app mobile o un gioco in una cartella sul tuo computer. Lavori in **Manus Studio**, l'app desktop di Manus per macOS (Apple Silicon) e Windows. Manus scrive il codice, esegue il progetto e mostra un'anteprima dal vivo. Usa i file, le cartelle e gli strumenti già presenti sul tuo computer. Per scoprire cosa può fare Manus Studio sul tuo computer, leggi [Manus Studio](https://manus.im/docs/it/features/desktop.md).

Usa questa funzionalità nei seguenti casi:

* Il tuo progetto si trova già sul tuo computer.
* Vuoi mantenere il tuo flusso di lavoro Git.
* Vuoi usare i tuoi strumenti insieme a Manus.

Puoi usare lo stesso flusso di lavoro anche su un [Cloud Computer](https://help.manus.im/en/articles/15392111-what-is-the-cloud-computer). In questo caso, la cartella del progetto si trova sul Cloud Computer anziché sul tuo computer.

Per ogni sito web o app mobile, scegli uno tra due tipi di progetto:

| Termine | Cosa significa |
| :- | :- |
| **Progetto gestito da Manus** | Il progetto si collega ai servizi di Manus, come hosting, database, accesso utenti, funzionalità di IA, cronologia delle versioni e pubblicazione. Puoi anche continuare il progetto in Manus sul web. |
| **Progetto locale semplice** | Un normale progetto sul tuo computer. Usi i tuoi strumenti e servizi. Manus non configura hosting, pubblicazione o altri servizi di Manus. |
| **Cronologia delle versioni di Manus** | L'elenco delle versioni salvate che Manus conserva per un progetto gestito da Manus. È separata dal tuo repository Git. |

La tabella mostra quali opzioni si applicano a ciascun tipo di progetto.

| Tipo di progetto | Le tue opzioni | Dove avviene lo sviluppo |
| :- | :- | :- |
| **Sito web o app web** | Gestito da Manus o locale semplice | Il tuo computer |
| **App mobile** | Gestito da Manus o locale semplice | Gestito da Manus: Manus Cloud. Locale semplice: il tuo computer. |
| **Gioco** | Sempre gestito da Manus | Il tuo computer |

***

## Come si usa

### Configura Manus Studio

**1. Scarica Manus Studio**

Apri [manus.im/desktop](https://manus.im/desktop). Seleziona **macOS (Apple Silicon)** o **Windows**, quindi esegui il programma di installazione.

**2. Accedi**

Apri Manus Studio e accedi con il tuo account Manus. Se Manus ti chiede di aggiornare prima di usare una cartella locale, installa la versione più recente.

**3. Attiva Lavora in locale e scegli la cartella**

Nella casella della chat, attiva **Lavora in locale** (**Work locally**). Fai clic su **Scegli una cartella** (**Choose a folder**) e seleziona la cartella in cui si trova il tuo progetto, oppure quella in cui Manus deve crearlo. Leggi [Manus Studio](https://manus.im/docs/it/features/desktop.md) per le modalità di autorizzazione e l'accesso alle cartelle.

### Avvia un nuovo sito web sul tuo computer

**1. Descrivi il sito web e la sua posizione**

Avvia un'attività in Manus Studio. Descrivi il sito web e indica a Manus dove crearlo sul tuo computer.

**2. Scegli un tipo di progetto**

Manus ti chiede come vuoi configurare il sito web. Seleziona **Manus-managed** (gestito da Manus) per usare hosting, database, accesso, cronologia delle versioni e pubblicazione di Manus. Seleziona **plain local** (locale semplice) per usare solo i tuoi strumenti e servizi.

**3. Consenti l'archiviazione del codice se la cartella non è vuota**

Per un progetto gestito da Manus, Manus controlla la cartella. Se contiene già dei file, Manus mostra una scheda **Archiviazione del codice del progetto** (**Project code storage**). La scheda chiede: "Allow Manus to sync your project's code?" (Consentire a Manus di sincronizzare il codice del progetto?). Fai clic su **Consenti e inizializza** (**Allow and initialize**) per continuare. Se annulli, Manus non configura il progetto.

**4. Rivedi il piano**

Manus presenta un piano per il sito web. Chiedi eventuali modifiche prima che Manus inizi a crearlo.

**5. Visualizza l'anteprima e perfeziona**

Manus esegue il sito web sul tuo computer e apre un'anteprima dal vivo in Manus Studio. Descrivi le modifiche che desideri nella stessa attività.

Prompt di esempio:

```text theme={null}
Build a booking website for my yoga studio in a new folder called yoga-site
in my Documents folder. Include a class schedule, a booking form, and a contact page.
```

> [!NOTE]
>
> Se hai già scelto un tipo di progetto nel prompt, ad esempio "mantienilo in locale, niente hosting di Manus", Manus non te lo chiede di nuovo.

### Continua un sito web già presente sul tuo computer

**1. Indica a Manus la cartella**

In Manus Studio, indica a Manus quale progetto continuare. Se puoi, fornisci il percorso completo della cartella.

**2. Conferma la copia corretta**

Manus cerca siti web di Manus in quella cartella e nelle cartelle vicine. Se Manus trova più di una corrispondenza, o se la corrispondenza non è chiara, ti chiede a quale ti riferisci.

**3. Scegli come collegare il codice esistente**

La cartella può contenere codice non ancora collegato a Manus. In questo caso, Manus ti chiede di scegliere tra gestito da Manus e locale semplice. Manus conserva i tuoi file esistenti e non vi applica sopra un template iniziale.

### Aggiungi un sito web a un progetto più ampio

Puoi aggiungere un sito web a un progetto che non è un sito web, ad esempio un sito ufficiale per un gioco.

1. Di' a Manus che vuoi un sito web separato all'interno del progetto più ampio. Ad esempio: "Aggiungi un sito web ufficiale per questo gioco."
2. Manus crea il sito web in una sottocartella dedicata, ad esempio `website/`.
3. Solo quella sottocartella appartiene al sito web. Manus non include il resto del progetto nelle versioni del sito web.

### Crea un'app mobile

**1. Descrivi l'app**

In Manus Studio, descrivi l'app mobile che vuoi creare.

**2. Scegli un tipo di progetto**

Manus ti chiede di scegliere prima di iniziare. **Manus-managed** (gestito da Manus) ti offre backend, database, accesso, funzionalità di IA, cronologia delle versioni e build dell'app. **Plain local** (locale semplice) mantiene lo sviluppo sul tuo computer con il tuo backend e i tuoi servizi.

**3. Conferma il passaggio a Manus Cloud**

Al momento, un'app mobile gestita da Manus viene eseguita in Manus Cloud. Se scegli questa opzione, Manus sposta l'attività dal tuo computer a Manus Cloud prima che inizi lo sviluppo. Manus ti informa di questo passaggio prima che tu scelga.

> [!WARNING]
>
> I file nella tua cartella locale potrebbero non essere spostati insieme all'attività in Manus Cloud. Se hai del codice esistente, avvisa Manus prima di scegliere, così potrà pianificare come trasferirlo.

### Crea un gioco

1. In Manus Studio, descrivi il gioco e indica a Manus dove crearlo sul tuo computer.
2. Manus configura il gioco come progetto gestito da Manus. Non ti chiede di scegliere un tipo di progetto.
3. Prosegui con il normale flusso di lavoro di Game Dev. Leggi [Game Developer](https://manus.im/docs/it/features/game-developer.md).

### Salva le versioni e pubblica un progetto gestito da Manus

**1. Chiedi a Manus di salvare una versione**

Quando sei soddisfatto di una modifica, chiedi a Manus di salvare una versione. Manus carica una copia del codice della cartella del sito web in un repository privato gestito da Manus. Manus usa questa copia solo per la cronologia delle versioni e la pubblicazione.

**2. Pubblica quando sei pronto**

Chiedi a Manus di pubblicare, oppure pubblica come descritto in [Pubblicazione](https://manus.im/docs/it/website-builder/publishing.md). Manus chiede "Allow Manus to publish?" (Consentire a Manus di pubblicare?). Scegli **Consenti una volta** (**Allow once**), oppure **Consenti sempre per questo sito web** (**Always allow for this website**) per saltare questa domanda la prossima volta. Solo il proprietario del progetto può pubblicare un progetto locale. Salvare una versione non pubblica di per sé il tuo sito web, a meno che tu non abbia attivato la pubblicazione automatica.

> [!NOTE]
>
> Un commit nel tuo repository Git non crea una versione di Manus e non pubblica il tuo sito web.

### Testa i pagamenti Stripe in un progetto locale

1. Chiedi a Manus di aggiungere i pagamenti. Manus configura Stripe in modalità test. Leggi [Pagamenti](https://manus.im/docs/it/website-builder/payments.md).
2. Testa il checkout con la carta di test di Stripe `4242 4242 4242 4242`.
3. Per un test completo dei pagamenti, Stripe deve inviare gli eventi di pagamento (webhook) alla tua app. Un'anteprima sul tuo computer non può ricevere questi eventi. Chiedi a Manus di spostare il progetto in una sandbox cloud temporanea per questo test. Manus ti chiede prima l'approvazione.
4. Prima di pubblicare per la prima volta, chiedi a Manus di collegare il webhook di Stripe da un'anteprima cloud.

### Collega in seguito un progetto locale semplice a Manus

1. Apri la cartella del progetto in Manus Studio.
2. Chiedi a Manus di collegare il sito web a Manus.
3. Manus collega la cartella esistente a un nuovo progetto gestito da Manus. Conserva i tuoi file sorgente e non ricrea il sito web.

Questo vale per siti web e app web. Per trasformare un'app mobile locale semplice in un progetto gestito da Manus, Manus sposta l'attività in Manus Cloud e valuta come trasferire il tuo codice.

***

## Cosa devi sapere

### Cosa viene eseguito e dove

* **L'anteprima viene eseguita sul tuo computer.** Manus Studio apre l'anteprima da un indirizzo locale sul tuo computer. Altri dispositivi non possono aprire questo indirizzo.
* **Condividi con altri pubblicando.** Per permettere ad altre persone di vedere il sito web, pubblicalo oppure continua l'attività in Manus Cloud.
* **Sincronizza prima di continuare nel cloud.** Una nuova attività cloud parte dall'ultima versione sincronizzata. Le modifiche presenti solo sul tuo computer non sono incluse. Chiedi prima a Manus di sincronizzare, poi seleziona **Continua in una nuova attività cloud** (**Continue in a new cloud task**).
* **Solo il proprietario può usare i file locali.** I file locali, la pubblicazione locale e la continuazione in una nuova attività sono disponibili solo per il proprietario del progetto.
* **Le app mobile gestite vengono eseguite in Manus Cloud.** Siti web, app web e giochi restano sul tuo computer. Le app mobile gestite da Manus vengono spostate in Manus Cloud.

### Cosa carica Manus

* **Progetti gestiti da Manus:** quando salvi o sincronizzi una versione, Manus carica il codice della cartella del sito web. Non carica il resto di un progetto più ampio, come il gioco a cui è associato un sito web.
* **La sola configurazione non carica il codice.** Collegare una cartella o configurare un progetto gestito da Manus non carica di per sé il tuo codice.
* **Scegliere un progetto gestito da Manus non pubblica nulla.** Il tuo sito web diventa pubblico solo quando lo pubblichi.
* **Progetti locali semplici:** Manus non configura i servizi di Manus e non salva versioni su Manus. Puoi collegare il progetto a Manus in seguito.

### Come funziona Manus con il tuo repository Git

* **Due cronologie separate.** Manus conserva una propria cronologia delle versioni per un progetto gestito da Manus. Il tuo repository Git e la sua cronologia restano separati.
* **La tua configurazione Git non cambia.** Manus non modifica i tuoi remote, branch, hook o credenziali. Non importa la tua cronologia Git.
* **I commit non vengono copiati.** I tuoi commit non compaiono nella cronologia delle versioni di Manus e le versioni di Manus non compaiono come commit nel tuo repository.
* **File condivisi.** Entrambe le cronologie tengono traccia degli stessi file nella cartella. Quando Manus applica modifiche dalla propria cronologia, queste compaiono nel tuo repository Git come modifiche non committate.
* **Cartelle senza un proprio repository Git.** Se la cartella del sito web non si trova all'interno di un repository Git, i tuoi strumenti Git mostrano la cronologia delle versioni di Manus per quella cartella. Per usare un repository separato in quella cartella, chiedi a Manus di configurarlo. Non eseguire tu stesso `git init` in quella cartella.
* **Manus aggiunge due elementi alla cartella del sito web.** Un piccolo file di progetto collega la cartella al tuo progetto Manus. Una cartella nascosta memorizza la cronologia delle versioni di Manus. Non eliminare nessuno dei due. Non eseguire il commit della cartella nascosta nel tuo repository.
* **Worktree e branch Git.** Puoi eseguire il commit del piccolo file di progetto nel tuo repository. Un nuovo branch o worktree resterà così collegato allo stesso progetto Manus.
* **Progetti cloud e GitHub.** Per i progetti che crei in Manus Cloud, leggi [Integrazione GitHub](https://manus.im/docs/it/website-builder/github-integration.md) e [Controllo del Codice](https://manus.im/docs/it/website-builder/code-control.md).

### Limitazioni attuali

* **Il rollback non è ancora disponibile per i progetti locali.** Non puoi ripristinare un progetto locale gestito da Manus a una versione salvata precedente. Per annullare le modifiche, usa la tua cronologia Git.
* **Il test completo dei webhook di Stripe richiede una sandbox cloud.** Il checkout in modalità test funziona in locale. Gli eventi di pagamento richiedono una sandbox cloud temporanea.
* **I giochi sono sempre gestiti da Manus.** L'opzione locale semplice non è disponibile per i giochi.
* **Le app mobile gestite richiedono Manus Cloud.** Non puoi sviluppare un'app mobile gestita da Manus sul tuo computer.

### Strumenti sul tuo computer

* **Manus usa gli strumenti che hai.** Manus usa i linguaggi di programmazione, i gestori di pacchetti e gli altri strumenti installati sul tuo computer.
* **I pacchetti del progetto vengono installati durante l'attività.** Manus installa i pacchetti di cui il tuo progetto ha bisogno, usando le impostazioni del progetto stesso.
* **Le modifiche al sistema richiedono la tua autorizzazione.** Prima di installare o riparare uno strumento per l'intero computer, Manus spiega la modifica e ti chiede l'autorizzazione. Non usa i diritti di amministratore senza la tua approvazione.

### Spostare o copiare la cartella di un progetto

* **Sposta l'intera cartella.** Se sposti o rinomini l'intera cartella del sito web, il collegamento al tuo progetto Manus e la sua cronologia delle versioni restano intatti.
* **Copiare solo il file di progetto non crea un nuovo sito web.** La copia punta allo stesso progetto Manus. Chiedi invece a Manus di configurare un nuovo progetto.

### Crediti

Le attività che lavorano con il tuo computer consumano crediti alla stessa tariffa delle attività equivalenti nel cloud. Il costo dipende dalla complessità dell'attività, non dalla posizione dei file. Leggi [Understanding Credit Consumption in the Manus Desktop App](https://help.manus.im/en/articles/14134826-understanding-credit-consumption-in-the-manus-desktop-app).

***

## Suggerimenti

* **Fornisci a Manus il percorso completo della cartella.** Un percorso completo, come `~/Documents/yoga-site`, aiuta Manus a trovare subito il progetto giusto.
* **Usa una cartella nuova e vuota per un nuovo sito web.** In questo modo Manus configura il progetto senza chiederti di confermare l'archiviazione del codice.
* **Indica il tipo di progetto nel primo prompt.** Scrivi "gestito da Manus" o "mantienilo in locale" per saltare la domanda di configurazione.
* **Scegli un progetto gestito da Manus se prevedi di pubblicare con Manus.** Ottieni hosting, cronologia delle versioni e pubblicazione senza configurazioni aggiuntive.
* **Tieni un sito web associato in una sottocartella dedicata.** In questo modo la cronologia delle versioni e i caricamenti includono solo il sito web, non l'intero progetto.
* **Esegui il commit del tuo lavoro in Git prima di modifiche importanti.** Il rollback non è ancora disponibile per i progetti locali gestiti da Manus, quindi la tua cronologia Git è la tua rete di sicurezza.
* **Esegui il commit del piccolo file di progetto, non della cartella nascosta.** In questo modo i tuoi branch e worktree restano collegati allo stesso progetto Manus.
* **Pianifica per tempo i test dei pagamenti.** Chiedi a Manus di configurare una sandbox cloud temporanea quando sei pronto a testare l'intero flusso di pagamento.
* **Pubblica per condividere.** Un'anteprima locale funziona solo sul tuo computer. Pubblica il sito web per inviare un link ad altre persone.

***

## Domande frequenti

> [accordion] Mi serve Manus Studio per sviluppare in locale?
>
> Sì. Per sviluppare sul tuo computer ti serve Manus Studio per macOS (Apple Silicon) o Windows. Scaricalo da [manus.im/desktop](https://manus.im/desktop). Puoi usare lo stesso flusso di lavoro anche su un Cloud Computer.

> [accordion] Qual è la differenza tra un progetto gestito da Manus e un progetto locale semplice?
>
> Un progetto gestito da Manus si collega ai servizi di Manus come hosting, database, accesso, cronologia delle versioni e pubblicazione. Un progetto locale semplice è un normale progetto sul tuo computer. Usi i tuoi strumenti e servizi, e Manus non configura hosting o pubblicazione.

> [accordion] Manus carica il mio codice?
>
> Per un progetto gestito da Manus, Manus carica il codice della cartella del sito web quando salvi o sincronizzi una versione. La configurazione del progetto non carica di per sé il codice. Per un progetto locale semplice, Manus non salva versioni su Manus.

> [accordion] Manus modificherà il mio repository Git?
>
> No. Manus conserva una propria cronologia delle versioni, separata dal tuo repository. Non modifica i tuoi remote, branch, hook o credenziali. Quando Manus modifica dei file, queste modifiche compaiono nel tuo repository come modifiche non committate.

> [accordion] Perché la mia attività per l'app mobile è stata spostata nel cloud?
>
> Al momento, un'app mobile gestita da Manus viene eseguita in Manus Cloud. Manus te lo comunica prima che tu scelga. Per mantenere l'app sul tuo computer, scegli invece lo sviluppo locale semplice.

> [accordion] Perché Manus non mi chiede di scegliere un tipo di progetto per il mio gioco?
>
> I giochi sviluppati in locale sono sempre gestiti da Manus. Manus configura il gioco con i servizi di Manus e passa al passaggio successivo.

> [accordion] Posso ripristinare un progetto locale a una versione precedente?
>
> Non ancora. In questa versione il rollback non è disponibile per i progetti locali gestiti da Manus. Esegui il commit nel tuo repository Git prima di modifiche importanti, così potrai ripristinare i file da solo.

> [accordion] Posso testare i pagamenti Stripe sul mio computer?
>
> Puoi testare il checkout nella modalità test di Stripe. Il test completo degli eventi di pagamento (webhook) richiede una sandbox cloud temporanea. Chiedi a Manus di configurarla. Manus ti chiede l'approvazione prima di spostare il progetto.

> [accordion] Qualcun altro può aprire la mia anteprima locale?
>
> No. L'anteprima viene eseguita a un indirizzo locale sul tuo computer. Per condividere il sito web, pubblicalo oppure continua l'attività in Manus Cloud.

> [accordion] Posso collegare in seguito un sito web locale semplice a Manus?
>
> Sì. Chiedi a Manus di collegare il sito web. Manus collega la cartella esistente a un progetto gestito da Manus e conserva i tuoi file sorgente.

> [accordion] Manus mi ha chiesto di installare uno strumento sul mio computer. Perché?
>
> Il tuo progetto ha bisogno di uno strumento mancante, obsoleto o non funzionante sul tuo computer. Manus spiega la modifica e ti chiede l'autorizzazione prima di installare o riparare uno strumento per l'intero computer.

> [accordion] Sviluppare in locale consuma più crediti?
>
> No. Le attività che lavorano con il tuo computer consumano crediti alla stessa tariffa delle attività equivalenti nel cloud. Leggi [Piani e Prezzi](https://manus.im/docs/it/introduction/plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.