왜 체크리스트가 필요한가
정적 배포는 파일만 올라가면 끝난 것처럼 보이지만, 실제로는 라우팅 fallback, API origin, canonical, sitemap이 조금만 어긋나도 사용자는 빈 페이지나 404를 만나게 됩니다.
배포 전 확인
VITE_SITE_URL이 공개 도메인의 bare origin인지 확인합니다.VITE_API_BASE_URL이 브라우저에서 접근 가능한 HTTPS origin인지 확인합니다.- SPA 라우트가
/index.html로 fallback되는지 확인합니다. - robots.txt와 sitemap.xml이 실제 배포 파일에 포함되는지 확인합니다.
배포 후 확인
배포 후에는 브라우저보다 먼저 curl -L로 HTML을 확인합니다. 검색엔진이 보는 초기 HTML에 h1, description, 글 제목, canonical이 들어 있는지 보면 SEO 문제를 빠르게 발견할 수 있습니다.
모바일 확인
360px, 390px, 430px 폭에서 버튼 터치 영역과 카드 줄바꿈을 확인합니다. 정적 페이지는 첫 인상이 중요하므로 글 카드가 한 화면에서 읽을 수 있어야 합니다.
결론
정적 배포는 파일 업로드보다 검증 루틴이 더 중요합니다. 배포 전 env, 배포 후 HTML, 마지막으로 모바일 화면을 확인하는 순서를 고정하면 실패 확률이 낮아집니다.