Salta ai contenuti

Installa Astro con la CLI Automatica

Pronto/a per installare Astro? Segui questa guida all’uso del comando CLI create astro per iniziare.

Prerequisiti

  • Node.js - v18.14.1 o superiore.
  • Editor di testo - Raccomandiamo VS Code con la nostra Estensione Ufficiale Astro.
  • Terminale - Astro viene utilizzato tramite la sua interfaccia da riga di comando (CLI).

Installazione

Il comando create astro è il modo più rapido per iniziare un nuovo progetto Astro partendo da zero. Ti guiderà ad ogni passo per impostare il tuo nuovo progetto Astro. Ti permette di scegliere tra diversi template ufficiali già pronti oppure puoi usare qualunque progetto esistente su GitHub con l’argomento --template.

1. Esegui lo strumento di setup

Esegui il seguente comando nel tuo terminale per eseguire il nostro utile strumento di installazione:

Terminal window
# crea un nuovo progetto con npm
npm create astro@latest

Puoi eseguire il comando create astro ovunque nel tuo computer, perciò non serve creare una nuova cartella vuota per il tuo progetto prima di cominciare. Se ancora non hai una cartella vuota per il tuo progetto, lo strumento ne creerà automaticamente una al tuo posto.

Se tutto va bene, dovresti vedere il messaggio “Liftoff confirmed. Explore your project!” (“Decollo confermato. Esplora il tuo progetto!”) seguito da alcuni suggerimenti per i prossimi passi. Entra nella nuova cartella del tuo progetto con il comando cd per iniziare ad usare Astro.

Se hai saltato il comando npm install durante l’esecuzione dello strumento CLI, allora assicurati di installare le dipendenze prima di continuare.

2. Fai partire Astro ✨

Astro arriva con un server di sviluppo integrato che ha tutto il necessario per lo sviluppo del tuo progetto. Il comando astro dev farà partire il server di sviluppo locale così che tu possa vedere il tuo sito in azione per la primissima volta.

Ogni template ufficiale arriva con uno script preconfigurato che eseguirà il comando astro dev al posto tuo. Usa il tuo package manager preferito per eseguire questo comando e lanciare il server di sviluppo locale di Astro.

Terminal window
npm run dev

Se tutto va bene, ora Astro dovrebbe servire il tuo progetto all’indirizzo http://localhost:4321/!

Astro osserverà ogni cambiamento ai file nella cartella src/, perciò non dovrai far ripartire il server ad ogni modifica nel progetto durante lo sviluppo.

Se non riesci ad aprire il tuo progetto nel browser, torna al terminale dove hai eseguito il comando dev e controlla se c’è stato un errore, o se il tuo progetto viene servito ad un indirizzo diverso da quello indicato precedentemente.

Template di partenza

Puoi anche iniziare un nuovo progetto Astro partendo da un esempio ufficiale o dal ramo main di una qualunque repository di GitHub passando l’argomento --template al comando create astro.

Terminal window
# crea un nuovo progetto con un esempio ufficiale
npm create astro@latest -- --template <nome-esempio>
# crea un nuovo progetto partendo dal ramo main di una repository di GitHub
npm create astro@latest -- --template <github-username>/<github-repository>

Questo comando userà di default il ramo main della repository. Per usare un altro ramo specificalo come parte dell’argomento --template: <github-username>/<github-repository>#<ramo>.

Esplora la vetrina dei nostri temi e starter dove puoi trovare temi per blog, portfolio, documentazione, pagine di marketing, e altri ancora! O cerca su GitHub per ancora più progetti starter.

Prossimi passi

Evviva! Ora sei pronto/a a costruire siti e applicazioni con Astro! 🥳

Ecco alcuni argomenti che ti consigliamo di esplorare ora. Li puoi leggere in ordine sparso. Puoi anche uscire dalla nostra documentazione per un po’ e andare a provare la codebase del tuo nuovo progetto Astro, e tornare qua se dovessi avere problemi o domande.

📚 Aggiungi un framework: Impara come estendere Astro con il supporto per React, Svelte, Tailwind e altri ancora usando il comando npx astro add nella nostra guida alle Integrazioni (EN).

📚 Pubblica il tuo sito: Impara come fare la build e pubblicare il tuo progetto sul web nella nostra guida alla Pubblicazione (EN).

📚 Conosci la tua codebase: Familiarizza con la struttura di un progetto Astro nella nostra guida alla Struttura del Progetto.