Estrutura de arquivos
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.
