Vercel은 Next.js를 잘 감지하지만, 모노레포 root, 빌드 명령, 환경 변수 범위는 사람이 확인해야 합니다.
단계
Vercel이 하는 일
사람이 확인할 것
나쁜 신호
저장소 선택
Git provider 권한으로 repo 목록 표시
배포할 repo와 branch 권한
repo가 안 보이거나 권한이 부족함
프레임워크 감지
Next.js preset과 기본 빌드값 제안
Root Directory, Build Command, Install Command
모노레포 하위 앱을 루트로 착각
빌드 실행
코드 clone, install, build, output 업로드
빌드 로그와 환경 변수 누락
로컬은 성공하지만 Vercel build만 실패
배포 URL 생성
Preview 또는 Production URL 발급
라우팅, 서버 함수, 이미지 최적화 동작
첫 화면만 뜨고 API/이미지가 실패