Referência da Interface de Linha de Comando
Comandos
Section titled Comandosastro dev
Section titled astro devExecuta o servidor de dev do Astro. Isso inicia um servidor HTTP que responde a requisições por rotas ou páginas que foram especificadas no diretório src/pages (a não ser que tenham sido sobrescritas pela sua opção pages definida na configuração do projeto).
Flags
--port
Section titled --portEspecifica em qual porta executar. Por padrão, 3000.
--host [endereço opcional do host]
Section titled --host [endereço opcional do host]Define em que endereços de IP o servidor de desenvolvimento deve ser escutado em (e.x. IPs que não sejam localhost).
--host- escuta em todos os endereços, incluindo endereços LAN e públicos.--host [endereço-customizado]- é exposto em um endereço de IP em[endereço-customizado]
astro build
Section titled astro buildFaz a build do seu site para produção.
astro preview
Section titled astro previewInicia um servidor local de arquivos estáticos para servir o seu diretório dist/ que foi construído. Útil para visualizar sua build estática localmente, antes de fazer seu deploy.
Esse comando foi feito apenas para testes locais, e não foi projetado para ser executado em produção. Para ajuda com hospedagens para produção, veja o nosso guia em Fazendo Deploy de um Website Astro.
astro check
Section titled astro checkRoda diagnósticos (como checar a tipagem de arquivos .astro) em seu projeto e reporta erros no console. Se algum error for encontrado durante o processo, ele será finalizado com o código 1.
Esse comando foi feito para ser usado em fluxos de trabalho de CI.
📚 Leia mais sobre o suporte para TypeScript no Astro.
astro add
Section titled astro addAdiciona uma integração a sua configuração.
astro docs
Section titled astro docsAbre o website de documentação do Astro diretamente do seu terminal.
astro telemetry
Section titled astro telemetryDefine a configuração de telemetria para o usuário atual. Telemetria são dados anônimos que provém informações sobre quais funcionalidades são mais utilizadas.
Telemetria pode ser desabilitada com o esse comando de linha de comando:
astro telemetry disable
Telemetria pode ser posteriormente habilitada com:
astro telemetry enable
O comando clear reseta os dados de telemetria:
astro telemetry clear
Flags Globais
Section titled Flags Globais--config path
Section titled --config pathEspecifica o caminho para seu arquivo de configuração. Por padrão, astro.config.mjs. Use isso se você utiliza um nome diferente para o seu arquivo de configuração ou você tem seu arquivo de configuração em outra pasta.
astro --config config/astro.config.mjs dev
--root path
Section titled --root pathEspecifica o caminho para a raiz do projeto. Se não for especificado, o diretório de trabalho atual é assumido como a raiz.
A raiz é utilizada para encontrar o arquivo de configuração Astro.
astro --root minhaPastaRaiz/minhaPastaDoProjeto dev
--reload
Section titled --reloadLimpa o cache (dependências são construídas em aplicações Astro).
--verbose
Section titled --verboseHabilita logging verboso, que é útil para depurar um problema.
--silent
Section titled --silentHabilita logging silencioso, que é útil quando você não quer ver logs do Astro.
--version
Section titled --versionMostra o número de versão do Astro.
--drafts
Section titled --draftsInclui páginas Markdown draft na build.
--help
Section titled --helpMostra a mensagem de ajuda e sai.