Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é roteamento por arquivo?

    O roteamento por arquivo usa nomes e pastas para definir URLs. No Astro, src/pages reúne páginas e rotas dinâmicas, geradas no build ou servidas no acesso.

    Também chamado de: file-based routing

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    O roteamento por arquivo usa os nomes e a organização dos arquivos para definir os endereços atendidos pelo site. No Astro, os arquivos de página ficam em src/pages. Uma página src/pages/sobre.astro, por exemplo, corresponde ao caminho /sobre.

    As pastas acrescentam segmentos ao endereço. O arquivo src/pages/empresa/contato.astro corresponde a /empresa/contato. Já o nome index.astro representa o endereço da própria pasta, por isso src/pages/empresa/index.astro corresponde a /empresa.

    Um arquivo para vários cursos

    Uma rota dinâmica usa um nome entre colchetes para receber parte do endereço. Neste exemplo didático, src/pages/cursos/[slug].astro pode representar páginas de cursos diferentes. Na geração estática, a função abaixo enumera os caminhos que serão produzidos.

    export function getStaticPaths() {
    return [
    { params: { slug: 'automacao' } },
    { params: { slug: 'desenvolvimento' } },
    ]
    }

    O resultado é a geração de /cursos/automacao e /cursos/desenvolvimento. Dentro da página, Astro.params.slug fornece o segmento correspondente. A declaração de [slug] não cria páginas estáticas para qualquer nome digitado no navegador. Cada caminho precisa constar no retorno de getStaticPaths().

    Endereço e forma de renderização

    Na renderização sob demanda, o servidor recebe o endereço e monta a página compatível com o parâmetro recebido. Essa modalidade exige a configuração e o adaptador adequados à hospedagem. O código da página ainda precisa verificar se o curso solicitado existe.

    Os exemplos mostram os caminhos sem um prefixo de publicação. A configuração base pode acrescentar esse prefixo e a política de barra final também afeta a URL utilizada. Você precisa conferir esses ajustes ao comparar o arquivo com o endereço aberto no navegador.

    Dúvidas frequentes

    Perguntas frequentes sobre roteamento por arquivo

    Um componente em src/components cria uma página?
    Esse diretório guarda componentes reutilizáveis e não cria rotas automaticamente. No Astro, as páginas seguem as convenções de nomes e formatos aceitos em src/pages.
    Uma rota dinâmica é renderizada a cada acesso?
    Ela também pode ser pré-renderizada. Nesse caso, getStaticPaths enumera os caminhos durante o build. A renderização sob demanda atende a rota no servidor quando chega uma requisição.
    Como representar o endereço /sobre?
    Você pode usar src/pages/sobre.astro ou src/pages/sobre/index.astro. As duas formas representam o mesmo caminho. Escolha uma delas para evitar duas definições concorrentes.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    No desenvolvimento com agentes, conferir os arquivos de rota permite verificar quais endereços a aplicação deve atender.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano