Criação de um projeto
O comando npm create astro@latest abre o assistente de criação de projetos Astro. Os scripts do projeto executam o servidor local, o build e a prévia do site gerado.
Criação do projeto
| Comando | Função |
|---|---|
npm create astro@latest |
Abre o assistente interativo |
npm create astro@latest -- site-exemplo --template minimal |
Usa a pasta site-exemplo e o template oficial minimal |
cd site-exemplo |
Muda o diretório do terminal para a pasta criada |
npm install |
Instala as dependências, caso a instalação tenha sido omitida no assistente |
No comando com npm, o -- separa os argumentos enviados ao assistente. O nome depois dele indica a pasta de destino.
npm create astro@latest -- site-exemplo --template minimalScripts do projeto
Os scripts abaixo constam no template minimal oficial. Eles são executados na pasta que contém o package.json.
| Comando npm | Comando do Astro | Função |
|---|---|---|
npm run dev |
astro dev |
Inicia o servidor de desenvolvimento |
npm run build |
astro build |
Gera o site para publicação |
npm run preview |
astro preview |
Serve o build local para conferência |
npm run astro -- --help |
astro --help |
Exibe as opções do CLI |
O preview usa o build existente. Ele não substitui um servidor de produção, conforme a referência do CLI.
Servidor de desenvolvimento
| Item | Comportamento |
|---|---|
| Endereço local padrão | http://localhost:4321/ |
Alterações em src/ |
Atualizam a prévia enquanto o servidor está ativo |
npm run dev -- --port 4400 |
Define a porta 4400 |
npm run dev -- --host |
Expõe o servidor nos endereços de rede disponíveis |
Ctrl+C |
Interrompe o processo no terminal |
A porta em uso aparece na saída do servidor. O guia de desenvolvimento descreve a atualização da prévia durante a edição dos arquivos.
