Ir para o conteúdo
Promovaweb

Estrutura de arquivos

Revisado em

Um projeto Astro separa o código processado em src/ dos arquivos copiados sem processamento em public/. Os arquivos de página em src/pages/ definem as rotas do site.

Pastas de origem

Caminho Função Organização
src/ Código-fonte processado pelo Astro Diretório de origem
src/pages/ Páginas e endpoints que geram rotas Diretório reservado pelo Astro
src/components/ Componentes reutilizáveis Convenção, com nome livre
src/layouts/ Estruturas compartilhadas por páginas Convenção, com nome livre
src/styles/ Arquivos de estilos importados pelo código Convenção, com nome livre
public/ Arquivos copiados sem processamento Mantém os nomes dos arquivos

A estrutura oficial apresenta as convenções de organização. As pastas components, layouts e styles não precisam existir num projeto mínimo.

Caminhos e endereços

Arquivo Endereço ou uso
src/pages/index.astro Rota /
src/pages/sobre.astro Rota /sobre/
src/pages/guias/index.astro Rota /guias/
src/components/Cabecalho.astro Importado por outro arquivo, sem rota própria
public/favicon.svg Arquivo acessível em /favicon.svg
public/robots.txt Arquivo acessível em /robots.txt

Um link para um arquivo de public/ omite o nome dessa pasta. Um componente fora de src/pages/ não cria endereço por si só.

Configurações do template minimal

Arquivo Conteúdo ou função
astro.config.mjs Configuração do Astro, inicialmente com defineConfig({})
package.json Dependências e scripts npm
tsconfig.json Estende astro/tsconfigs/strict
.vscode/extensions.json Recomenda astro-build.astro-vscode
.vscode/launch.json Configuração de depuração do VS Code
.gitignore Inclui dist/, .astro/ e node_modules/ entre os caminhos ignorados
AGENTS.md Orientações para agentes de código
README.md Documentação inicial do projeto

O template minimal também inclui src/pages/index.astro e os ícones public/favicon.ico e public/favicon.svg.

Diretórios gerados

Diretório Origem Conteúdo
node_modules/ Instalação das dependências Pacotes npm instalados
.astro/ Comandos do Astro Arquivos gerados, como types.d.ts
dist/ Build com configuração padrão Saída para publicação

Esses diretórios ficam fora do versionamento pelo .gitignore do template. O código editável permanece nos arquivos de origem.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.