Typ aplikace a builder

Static versus dynamic

Použijte static pouze tehdy, když výstup obsahuje výhradně browserové soubory a nevyžaduje server, SSR, API, autentizační callback, worker ani runtime renderování.

Použijte dynamic pro Next.js, Express, NestJS, Django, Laravel, Rails, API a full-stack frameworky. V pochybnostech je bezpečnější dynamic.

U statického client-side routeru zapněte SPA fallback. Nezapínejte ho pro klasický vícestránkový statický web.

Builder

• auto je preferovaný výchozí builder.
• dockerfile zvolte, když je zkontrolovaný Dockerfile produkčním kontraktem nebo jsou nutné systémové balíčky a build kroky, které automatická detekce neumí vyjádřit.
• railpack použijte pouze při explicitním požadavku repozitáře nebo po diagnostice konkrétní nekompatibility.

Adresáře

Kořenový projekt používá baseDirectory=/. V monorepu použijte absolutní cestu uvnitř repozitáře, například /apps/web, a ověřte, že build stále vidí workspace manifesty a sdílené balíčky.

U statické aplikace odvoďte publishDirectory ze skutečného buildu, například /dist. Nezadávejte běžný název bez ověření.

Automatická nasazení

U nové aplikace jsou vypnutá. Zapněte je až po stabilním prvním ručním nasazení a pouze pro větev, kterou skutečně chcete automaticky publikovat.