(ci): 🐛 GitHub Pages SPA 라우팅 지원 추가

puffcocos · claude · puffcocos · commit 1685d3bda711 · 2025-12-29T00:02:20.000+09:00
GitHub Pages에서 클라이언트 사이드 라우팅이 작동하도록 404.html 및 리다이렉트 로직을 추가했습니다. - rafgraph/spa-github-pages 방식 적용 - 404.html 생성: 존재하지 않는 경로 접근 시 쿼리 파라미터로 변환하여 리다이렉트 - index.html에 리다이렉트 스크립트 추가: 쿼리 파라미터를 원래 경로로 복원 - pathSegmentsToKeep = 1 설정 (Project Pages 대응) 이제 /example 경로로 직접 접근해도 정상적으로 작동합니다. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -42,6 +42,67 @@ jobs:
       - name: Build
         run: pnpm run build
 
+      - name: Create 404.html for SPA routing
+        run: |
+          cat > ./build/client/404.html << 'EOF'
+          <!DOCTYPE html>
+          <html>
+            <head>
+              <meta charset="utf-8">
+              <title>Single Page Apps for GitHub Pages</title>
+              <script type="text/javascript">
+                // Single Page Apps for GitHub Pages
+                // MIT License
+                // https://github.com/rafgraph/spa-github-pages
+                // This script takes the current url and converts the path and query
+                // string into just a query string, and then redirects the browser
+                // to the new url with only a query string and hash fragment,
+                // e.g. https://www.foo.tld/one/two?a=b&c=d#qwe, becomes
+                // https://www.foo.tld/?/one/two&a=b~and~c=d#qwe
+                // Note: this 404.html file must be at least 512 bytes for it to work
+                // with Internet Explorer (it is currently > 512 bytes)
+
+                // If you're creating a Project Pages site and NOT using a custom domain,
+                // then set pathSegmentsToKeep to 1 (enterprise users may need to set it to > 1).
+                // This way the code will only replace the route part of the path, and not
+                // the real directory in which the app resides, for example:
+                // https://username.github.io/repo-name/one/two?a=b&c=d#qwe becomes
+                // https://username.github.io/repo-name/?/one/two&a=b~and~c=d#qwe
+                // Otherwise, leave pathSegmentsToKeep as 0.
+                var pathSegmentsToKeep = 1;
+
+                var l = window.location;
+                l.replace(
+                  l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
+                  l.pathname.split('/').slice(0, 1 + pathSegmentsToKeep).join('/') + '/?/' +
+                  l.pathname.slice(1).split('/').slice(pathSegmentsToKeep).join('/').replace(/&/g, '~and~') +
+                  (l.search ? '&' + l.search.slice(1).replace(/&/g, '~and~') : '') +
+                  l.hash
+                );
+              </script>
+            </head>
+            <body>
+            </body>
+          </html>
+          EOF
+
+      - name: Add redirect script to index.html
+        run: |
+          # index.html의 <head> 태그 직후에 리다이렉트 스크립트 삽입
+          sed -i '/<head>/a\
+            <script type="text/javascript">\
+              (function(l) {\
+                if (l.search[1] === '/' ) {\
+                  var decoded = l.search.slice(1).split('\''&'\'').map(function(s) { \
+                    return s.replace(/~and~/g, '\''&'\'')\
+                  }).join('\''?'\'');\
+                  window.history.replaceState(null, null,\
+                      l.pathname.slice(0, -1) + decoded + l.hash\
+                  );\
+                }\
+              }(window.location))\
+            </script>' ./build/client/index.html
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
