Processo de build

O build é uma transformação ordenada. Primeiro valida as dependências fatais do projeto; só depois remove a saída anterior, prepara assets, renderiza todas as rotas e produz índices e imagens derivados das mesmas rotas. Assim, um clone sem o Tailwind local falha antes de apagar dist/.

As fases pertencem a sete grupos:

1. validar dependências locais;
2. preparar dist/;
3. transformar e copiar assets;
4. renderizar páginas;
5. gerar feeds, sitemap, robots, índices e contextos llms;
6. validar links internos e âncoras no HTML estático;
7. gerar capas e comprimir a saída.

O contexto do pipeline transporta o nome hasheado do CSS, o contexto de fontes e o manifest de assets para o rendering de páginas e capas. Isso permite que fontes e integrações opt-in, como o Remix Icon, publiquem arquivos locais hasheados sem codificar nomes de saída nos layouts ou templates de cover. Um RouteCatalog limitado à execução descobre o conteúdo uma vez e fornece as mesmas rotas a páginas, navegação, sitemap, llms.txt e capas. Para Collections com llms_full, ele também conserva os corpos MDX dessa mesma descoberta até gerar o consolidado; com mdx_source: true, conserva ainda o arquivo original completo para publicação da variante .mdx.

As capas são independentes entre si e executadas concorrentemente, com no máximo quatro processos por padrão. O modo --fast mantém todas as outras saídas e omite esse último estágio para encurtar a iteração local.

O pipeline mantém um cache incremental content-addressed em storage/framework/build-cache/. Covers são reutilizadas pela assinatura do HTML de cover renderizado, e os sidecars Brotli/gzip pela assinatura do arquivo textual. dist/ continua sendo limpo e remontado a cada execução; o cache só fornece artefatos derivados e nunca pode deixar uma rota removida na saída. --no-cache desliga esse mecanismo para diagnósticos ou builds de referência.

Uma exceção encerra o fluxo e impede os estágios seguintes. Warnings são acumulados e exibidos, mas o build continua; o caso comum é a ausência de histórico Git para calcular datas.

O resultado não contém runtime. Produção recebe somente dist/.

Para executar o fluxo, veja Publicar o site. Para a ordem normativa e os arquivos, consulte Saída gerada. A composição interna está em Pipeline e serviços.