Executar o build e o servidor local

Na imagem builder, nenhuma opção adicional é necessária:

docker run --rm \
  -v "$(pwd)/Content:/app/Content:ro" \
  -v "$(pwd)/config.yaml:/app/config.yaml:ro" \
  -v "$(pwd)/dist:/app/dist" \
  <imagem-pocket-banana>

Antes de alterar dist/, o build valida o Tailwind local em node_modules/.bin/tailwindcss. Se o executável estiver ausente ou sem permissão, instale as dependências com npm ci (ou npm install) na raiz do projeto. Depois dessa verificação, o build limpa dist/, compila assets, renderiza páginas e gera os arquivos auxiliares. Erros interrompem o pipeline; warnings de data Git usam mtime e não interrompem.

Para uma iteração local sem capas sociais, acrescente --fast. Use --profile para ver o custo de cada estágio e --cover-jobs=N para sobrescrever o paralelismo automático. Publicações devem continuar usando o build completo sem --fast.

As execuções seguintes reutilizam o cache incremental em storage/framework/build-cache/: covers e sidecars Brotli/gzip são indexados pelo conteúdo derivado. O dist/ continua sendo limpo a cada execução, então o cache não mantém arquivos de rotas removidas. Use --no-cache para ignorar e não gravar esses artefatos; isso não renova o cache de fontes, que é controlado separadamente por --refresh-fonts.

No repositório, use os recipes do justfile; eles constroem a imagem de desenvolvimento e executam o processo dentro do Docker:

just dev --port=8000
just serve --port=8000

dev compila o Core/Assets/main.css nativo e os CSS do projeto com watchers, renderizando as páginas dinamicamente por public/index.php. serve executa um build completo e serve dist/ por public/dist-router.php. Ambos dependem de public/, que não existe na imagem builder destinada ao cliente.

Para gerar o artefato sem servidor, use just build ou just build-fast. Os testes e a verificação de estilo também devem usar just test e just pint.

Para produção, publique somente dist/ em um servidor estático. O pipeline completo está em Processo de build; comandos e opções exatos estão na Referência da CLI.