🚀 Introduzione
- Prima di iniziare, assicurati di avere un editor di testo adatto per creare file HTML e CSS. Consigliamo Visual Studio Code o qualsiasi altro editor di tua preferenza.
- Successivamente, dovrai creare un account su Square Cloud, operazione che può essere effettuata tramite la pagina di accesso. Puoi usare la tua email, GitHub o entrambi per creare l’account.
- Infine, devi avere un piano a pagamento attivo sul tuo account. Puoi consultare i nostri piani e acquistarne uno in base alle tue esigenze qui.
Square Cloud offre supporto nativo per i progetti statici, come i siti HTML/CSS. Ciò significa che puoi ospitare facilmente i tuoi file HTML, CSS e altre risorse statiche sulla piattaforma. Con la CDN premium integrata, i tuoi siti saranno distribuiti rapidamente agli utenti di tutto il mondo.
Se stai caricando la tua applicazione tramite il sito web di Square Cloud, puoi ignorare la sezione seguente. Il sito crea automaticamente per te il file di configurazione
squarecloud.app.📄 File richiesti
- index.html (Esempio di file principale).
- vite.html (Esempio di file principale per progetti Vite).
- 404.html (File di routing per errori 404, opzionale).
🖥️ Preparare il progetto
Prima di ospitare il tuo progetto su Square Cloud, verifica innanzitutto che i file del progetto siano configurati correttamente per l’hosting.📤 Come ospitare il tuo progetto
Ora che hai preparato tutti i file per il tuo progetto HTML/CSS, il passo successivo è caricarli su Square Cloud e mettere online la tua applicazione. Esistono diversi modi per effettuare il caricamento, ma ne tratteremo due: tramite Dashboard o tramite CLI.Tramite dashboard
1
Accedi alla pagina di upload
Accedi alla pagina di upload e carica il file zip del tuo progetto.
2
Configura il tuo ambiente
Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.
3
Esegui il deploy del tuo progetto
Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4
Conferma che la tua app sia online
Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri
Se hai fatto il deploy di un sito web o di un’API, apri
https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.
Tramite CLI
Per utilizzare questo metodo, devi creare un file di configurazione chiamatosquarecloud.app nella directory principale del tuo progetto. Questo file conterrà la configurazione necessaria per il tuo progetto.
Guida al file di configurazione
Scopri come creare il file di configurazione
squarecloud.app che definisce l’ambiente della tua applicazione.1
Installa la CLI
Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non la hai ancora, esegui il seguente comando nel tuo terminale:Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:
- Windows
- Linux, macOS e WSL
2
Autenticati
Ora, per autenticarti e utilizzare gli altri comandi della CLI, troverai la tua chiave di autorizzazione qui cliccando su “Request API Key”. Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando:
3
Carica il tuo progetto
Infine, per eseguire il deploy della tua applicazione su Square Cloud tramite la CLI, devi eseguire il seguente comando:Oppure, se hai creato lo zip manualmente, puoi usare:
4
Conferma che la tua app sia online
Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:Se hai fatto il deploy di un sito web o di un’API, apri
https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

