fix: Vercel 새로고침 시 404 오류 해결

[koreahghg]

💡 배경 및 개요

PR을 하게 된 문제상황, 배경 및 개요에 대해서 작성해주세요!

퍼블리싱의 경우 스크린샷/동영상도 추가해주면 좋아요!

Resolves: #{이슈번호}

📃 작업내용

PR에서 한 작업을 작성해주세요!

🙋‍♂️ 리뷰노트

구현 시에 고민이었던 점들 혹은 특정 부분에 대한 의도가 있었다면 PR 리뷰의 이해를 돕기 위해 서술해주세요!

또한 리뷰어에게 특정 부분에 대한 집중 혹은 코멘트 혹은 질문을 요청하는 경우에 작성하면 좋아요!

e.g. 작업을 끝내야할 시간이 얼마 없어 확장성보다는 동작을 위주로 만들었어요! 감안하고 리뷰해주세요!

✅ PR 체크리스트

템플릿 체크리스트 말고도 추가적으로 필요한 체크리스트는 추가해주세요!

• 이 작업으로 인해 변경이 필요한 문서가 변경되었나요? (e.g. .env, 노션, README)
• 이 작업을 하고나서 공유해야할 팀원들에게 공유되었나요? (e.g. "API 개발 완료됐어요", "환경값 추가되었어요")
• 작업한 코드가 정상적으로 동작하나요?
• Merge 대상 브랜치가 올바른가요?
• PR과 관련 없는 작업이 있지는 않나요?

🎸 기타

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
cklob-gami	Ready	Preview, Comment	Dec 29, 2025 2:41am

[gemini-code-assist]

Summary of Changes

Hello @koreahghg, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 Vercel에 배포된 단일 페이지 애플리케이션(SPA)에서 사용자가 특정 경로에서 페이지를 새로고침할 때 발생하는 404 오류를 해결합니다. vercel.json 파일을 추가하여 모든 들어오는 요청을 index.html로 다시 작성하도록 Vercel을 구성함으로써, 클라이언트 측 라우터가 경로를 올바르게 처리할 수 있도록 합니다.

Highlights

• Vercel 404 오류 해결: Vercel 배포 환경에서 새로고침 시 발생하는 404 오류를 해결하기 위해 vercel.json 파일을 추가했습니다.
• vercel.json 파일 추가: 모든 경로 요청을 index.html로 리다이렉트하는 rewrites 설정을 포함하는 vercel.json 파일을 새로 생성했습니다.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

Vercel 배포 환경에서 새로고침 시 발생하던 404 오류를 해결하기 위해 vercel.json 파일을 추가하신 것을 확인했습니다. 추가된 rewrites 설정은 모든 경로 요청을 index.html로 보내주어 클라이언트 사이드 라우팅이 정상적으로 동작하도록 하는 올바른 해결 방법입니다. 이 변경으로 인해 SPA(Single Page Application)의 사용자 경험이 개선될 것입니다. 좋은 수정입니다.