기본 빌드 설정
Cloudflare Pages에서 Astro 프로젝트를 연결할 때 빌드 명령은 npm run build, 결과 폴더는 dist로 지정합니다. Node.js 버전은 프로젝트의 package.json에 적힌 범위와 맞추는 것이 안전합니다.
저장소 연결 뒤 확인
- 운영 브랜치가
main인지 확인합니다. - 빌드 결과 폴더가
dist인지 확인합니다. - 환경 변수가 있다면 Preview와 Production에 각각 넣습니다.
- 첫 배포 후 모바일에서도 글 주소가 직접 열리는지 확인합니다.
가장 단순한 배포 습관
로컬에서 npm run build가 성공한 뒤 push합니다. 이 한 단계만 지켜도 온라인 빌드에서 만나는 대부분의 실수를 미리 발견할 수 있습니다.