🍁 메이플랜드 유틸 모음
메이플랜드 유틸들을 한 도메인으로 모은 사이트입니다.
https://mapleland.myungwoo.kr
어떻게 한 도메인에 모이나
GitHub Pages 는 하나의 커스텀 도메인을 하나의 사이트에만 붙일 수 있습니다.
그래서 각 유틸 리포에 CNAME 을 나눠 붙이는 방식은 불가능합니다.
대신 이 리포가 도메인을 소유하고, 배포할 때 각 유틸 리포를 체크아웃해
/<슬러그> 하위 경로로 빌드한 뒤 한 덩어리로 올립니다.
dist/
├── index.html ← 랜딩 페이지 (scripts/build-site.mjs 가 생성)
├── 404.html
├── favicon.svg ← 랜딩 파비콘 (assets/ 에서 복사)
├── favicon-32.png ← 구형 브라우저 폴백
├── apple-touch-icon.png ← iOS 홈 화면
├── CNAME
├── damage/ ← damage-calculator 를 basePath=/damage 로 빌드한 결과
├── enhance/
├── exp/
├── hunt/
├── split/
└── damage-calculator/ ← 리포 이름으로 들어온 주소 → /damage 리다이렉트
└── ...
각 유틸 리포의 자체 배포(myungwoo.github.io/<repo>)는 그대로 살아 있습니다.
두 경로 모두 같은 소스에서 나옵니다.
빌드하는 쪽이 하위 경로를 정할 수 있어야 하므로, 각 유틸의 next.config 는
NEXT_PUBLIC_BASE_PATH 환경변수로 basePath 를 받습니다.
유틸 추가·수정
utils.json 만 고치면 됩니다. 랜딩 페이지 카드, 배포 대상, 리다이렉트가 모두
여기서 나옵니다.
{
"slug": "damage", // 사이트에서 쓸 경로 (/damage)
"repo": "damage-calculator",
"ref": "main", // 빌드할 브랜치/태그
"emoji": "🗡️",
"name": "데미지 계산기",
"summary": "카드에 들어갈 한두 문장",
"highlights": ["카드 하단 태그", "3개 정도"]
}
새 유틸 리포에 필요한 것:
NEXT_PUBLIC_BASE_PATH 를 읽어 basePath 를 정하고, output: "export" 로 out/ 을
내보냅니다.- localStorage 키에
ml:<슬러그>: 접두어를 붙입니다. 유틸들이 한 오리진을 공유하므로
접두어 없는 키는 다른 유틸의 설정을 덮어씁니다. 테마만 예외로 ml:theme 을 함께 쓰고,
값은 'light' | 'dark' | 'system' 입니다. 자세한 규칙은 CLAUDE.md 참고.
로컬에서 확인
node scripts/build-site.mjs # dist/ 에 랜딩 페이지 생성
npx serve dist # 또는 python3 -m http.server -d dist
유틸 본체까지 포함한 사이트 전체는 배포 워크플로가 조립합니다.
랜딩 페이지만 볼 때는 유틸 카드 링크가 404 로 뜨는 게 정상입니다.
카드는 새 탭에서 열립니다. 각 유틸이 자기 파비콘을 가지고 있어서, 같은 탭에서 열면
돌아온 뒤에도 그 아이콘이 탭에 남기 때문입니다. 랜딩만 favicon.svg(M 마크)를 쓰고,
유틸 아이콘은 그대로 둡니다.
배포
main 에 푸시하면 배포됩니다.
유틸 리포가 업데이트되어도 이 리포에는 푸시가 없으므로, 각 유틸의 배포 워크플로가
마지막에 이 리포로 repository_dispatch(utils-updated) 를 보내 재빌드를 트리거합니다.
유틸 리포에는 이 리포에 대한 Contents 쓰기 권한만 가진 fine-grained PAT 를
MAPLELAND_UTILS_DISPATCH 시크릿으로 넣어 둡니다.
매일 03:00(KST) cron 은 알림이 유실되거나 PAT 가 만료됐을 때를 위한 안전망입니다.
즉시 반영이 필요하면 Actions 에서 Deploy 를 수동 실행하세요.
