HM소프트

같은 정적 산출물을 데모(하위 경로)와 임베디드 장비(루트)에 동시 배포하는 파이프라인을 만들었다. BASE_PATH 경로 확정, 백엔드 없는 fetch 심, .nojekyll 자동 생성, 그리고 공식 배포 액션이 CDN 장애로 다운됐을 때 gh-pages 직접 미러링으로 우회한 과정과 Yocto·Apache 장비 배포까지 다룬다.코드가 멀쩡해도 배포가 안 되는 날한 커피머신 제조사의 키오스크 UI를 만든 시리즈의 마지막 편이다. 1편에서는 기기와의 WebSocket 실시간 연동(추출구 상태 봉투, 재연결, 폴링 인계)을, 2편에서는 PWA 풀스크린과 태블릿 가독성을 다뤘다. 두 편 모두 "내 코드 안의 문제"였다. 그런데 이 프로젝트에서 정작 가장 많은 시간을 빼앗은 건 코드가 아니라 배포였다.이 UI..

장부 관리 데모 앱을 GitHub Pages에 올리며 밟은 Vite·React 빌드·배포 함정 기록. npm ci와 lock 정합성, tsc -b 타입 검사 차단, Tailwind v4 @apply 미적용, body overflow-hidden 전역 스타일 사고, SPA 새로고침 404를 HashRouter로 회피, base 경로와 단일 CSS 번들, Pages 배포 권한까지 순서대로 다룹니다. 2편: 빌드와 배포1편에서 에디토리얼 스타일 UI를 다뤘다. 이번 편은 이 데모를 GitHub Pages에 올리며 만난 실전 트러블슈팅이다. 작은 데모라도 "빌드가 통과하고, CI가 돌고, 정적 호스팅에서 보이게" 하는 데는 잔 함정이 많았다.1) CI 실패: npm ci vs npm installGitHub A..