Kategoria: Vercel i hosting

Vercel: wdrożenie READY, ale strona pokazuje pusty katalog

Poradnik techniczny · Kacper Bernecki

Build kończy się sukcesem, lecz domena zwraca 404 albo pusty widok po publikacji. Ustawiony Output Directory lub preset frameworka może wskazywać katalog inny niż rzeczywisty rezultat buildu.

Jak ustalić źródło błędu

Sprawdź framework preset, Build Command i Output Directory projektu.

Porównaj artefakty lokalnego buildu z oczekiwaniami wybranego frameworka, np. Next.js vs statyczne Vite.

Co zrobić krok po kroku

1. Usuń przestarzałe ręczne ustawienie output, jeśli framework zarządza nim automatycznie.

2. Dla statycznego generatora ustaw rzeczywisty katalog wynikowy i przebuduj projekt.

Jak sprawdzić wynik

Adres produkcyjny zwraca poprawny HTML i ładuje JS/CSS, a nie tylko status READY w panelu.

Czego nie robić

Nie traktuj udanego deploymentu jako testu działania strony dla odwiedzających.