코딩 초보의 도전, 웹앱 디자인에서 실제 서비스 배포까지
2026.10.20
소개
gatekit으로 시작해 단체여행 투표 사이트를 만들기까지
1. 시작은 1주차 스터디에서
지피터스 24기 클로드 코드 스터디 1주차에는 gatekit을 활용해 웹앱을 설계하고 디자인하는 방법을 배웠다.
이전에 클로드 코드를 활용해 웹디자인 등을 경험한 적은 있었지만, 여전히 코딩은 낯설었다. AI에게 요청하면 화면이 만들어지는 것은 신기했지만, 그 결과물을 어떻게 관리하고 실제 서비스로 연결해야 하는지는 잘 알지 못했다.
이번 스터디에서 특히 인상적이었던 것은 단순히 코드를 빠르게 만드는 것이 아니라, 무엇을 만들 것인지 먼저 정의하고, 결과물을 검증하며, 실제 사용자가 있는 서비스로 발전시키는 과정을 강조한다는 점이었다.
배운 내용을 실제 상황에 적용해 보고 싶었다. 마침 단체여행을 준비하면서 여러 사람의 의견을 모으고 일정을 결정해야 할 필요가 있었다.
그래서 단체여행을 위한 투표 웹앱을 직접 만들어 보기로 했다.
2. 디자인에서 실제 작동하는 웹앱으로
처음에는 참여자들이 편리하게 의견을 전달할 수 있는 화면을 만드는 것부터 시작했다.
하지만 웹앱은 보기 좋은 화면만으로 완성되지 않았다. 투표에 필요한 정보를 어떻게 구성할지, 데이터를 어디에 저장할지, 다른 사람들이 어떻게 접속할 수 있도록 할지까지 생각해야 했다.
이 과정에서 ChatGPT와 함께 작업하며 여러 기술을 접하게 되었다.
Next.js와 TypeScript: 웹앱의 화면과 기능 구현
Supabase: 투표 데이터 저장과 관리
GitHub: 코드 보관과 수정 이력 관리
Vercel: 인터넷에 웹앱 배포
처음에는 이름조차 낯설었던 도구들이었다.
AI가 코드를 제안하면 나는 직접 파일을 열어 수정하고, 명령어를 실행하고, 결과를 확인했다. 이해되지 않는 부분은 다시 질문했다.
특히 한꺼번에 여러 단계를 진행하면 쉽게 혼란스러워졌기 때문에, 한 단계씩 설명을 듣고 직접 실행한 뒤 다음 단계로 넘어가는 방식으로 작업했다.
3. 코딩보다 더 어려웠던 작업 환경
실제 제작 과정에서 가장 어려웠던 것은 의외로 코드 자체만이 아니었다.
어떤 폴더에서 작업해야 하는지, 수정한 파일이 어디에 저장되는지, 명령 프롬프트에서 어느 경로로 이동해야 하는지부터 익혀야 했다.
수정 작업을 반복하면서 비슷한 이름의 프로젝트 폴더도 여러 개 생겼다. 어느 것이 이전 수정본이고, 어느 것이 현재 운영 중인 사이트와 연결되어 있는지 구분하는 일도 쉽지 않았다.
또한 내 컴퓨터에서 코드를 수정하는 것과 인터넷에 공개된 사이트를 수정하는 것은 다른 과정이었다.
코드를 저장한 뒤 GitHub에 변경 사항을 반영하고, Vercel에서 배포가 이루어진 다음, 실제 사이트에 접속해 결과를 확인해야 했다.
이 과정을 반복하면서 조금씩 전체 흐름을 이해하게 되었다.
4. 배포 이후에도 계속된 수정과 검증
가장 의미 있었던 순간은 웹앱을 실제 인터넷에 배포했을 때였다.
내 컴퓨터에서만 확인하던 화면이 아니라, 다른 사람들도 링크를 통해 접속할 수 있는 사이트가 된 것이다.
하지만 배포가 끝은 아니었다.
특히 투표 마감일을 안내하는 D-day 표시를 수정하는 과정에서 날짜와 시간 처리 문제를 경험했다.
화면에 원하는 문구를 표시하는 것처럼 보였지만, 실제로는 날짜를 계산하는 코드와 연결되어 있었다.
AI와 함께 원인을 확인하고 코드를 수정한 뒤, GitHub에 변경 사항을 반영하고 실제 배포된 사이트에서 다시 확인했다.
이때 AI가 코드를 만들어 주었다는 사실보다, 수정한 결과가 실제로 제대로 작동하는지 확인하는 일이 더 중요하다는 것을 실감했다.
스터디에서 강조한 ‘정의하고, 만들고, 검증하는 과정’이 실제 작업에서 어떤 의미인지 조금씩 이해하게 되었다.
5. 완성 이후에 발견한 또 다른 과제
사이트를 배포한 뒤에는 컴퓨터에 쌓여 있는 여러 수정본과 백업 폴더를 정리하기 시작했다.
처음에는 비슷한 폴더들이 수백 MB씩 용량을 차지하고 있었지만, 무엇을 지워도 되는지 알 수 없었다.
AI와 함께 파일을 하나씩 확인하면서 node_modules, .next처럼 다시 설치하거나 생성할 수 있는 파일과 src, supabase, package.json처럼 보관해야 할 원본 파일을 구분했다.
그 결과 여러 예전 작업 폴더의 용량을 크게 줄일 수 있었다.
그러나 이름이 같은 파일이라고 해서 모두 동일한 내용은 아니라는 사실도 알게 되었다. 수정본마다 중요한 변경 사항이 있을 수 있으므로, 원본 코드는 비교하기 전까지 보관하기로 했다.
웹앱을 만드는 것뿐 아니라 작업 결과물을 안전하게 관리하는 일도 서비스 개발의 일부라는 것을 배우고 있다.
6. 이번 경험에서 배운 것
이번 경험을 통해 가장 크게 달라진 것은 AI를 활용하는 방식이다.
처음에는 AI가 얼마나 빠르게 화면을 만들어 주는지가 신기했다.
그러나 실제로 웹앱을 제작하고 배포하면서 중요한 것은 속도만이 아니라는 사실을 알게 되었다.
내가 무엇을 원하는지 구체적으로 설명해야 하고, AI가 제안한 결과가 맞는지 직접 확인해야 한다. 오류가 발생하면 상황을 정확하게 전달하고, 수정한 뒤 다시 검증해야 한다.
무엇보다 AI가 만들어 준 코드를 무조건 따라 하는 것과, 그 코드가 어떤 역할을 하는지 조금씩 이해하면서 사용하는 것은 다르다는 것을 느꼈다.
아직 혼자서 코드를 자유롭게 작성할 수 있는 수준은 아니다. 하지만 이제는 GitHub가 왜 필요한지, Vercel이 어떤 역할을 하는지, 내 컴퓨터를 꺼도 배포된 사이트가 운영되는 이유를 조금씩 이해하고 있다.
이런 작은 이해들이 쌓이는 과정 자체가 나에게는 중요한 배움이었다.
7. 마무리 — 프로토타입을 넘어 실제 서비스로
1주차에 gatekit을 활용해 웹앱을 설계하고 디자인하는 방법을 배웠을 때만 해도, 실제 인터넷에 서비스를 배포하는 단계까지 경험하게 될 것이라고는 생각하지 못했다.
이번 단체여행 투표 사이트 제작은 배운 것을 실제 필요에 적용해 본 경험이었다.
화면을 디자인하는 것에서 시작해 기능을 구현하고, 데이터를 연결하고, GitHub와 Vercel을 통해 배포했다. 이후에도 오류를 수정하고 결과를 확인하면서 운영에 필요한 과정을 경험했다.
스터디에서 강조하는 것은 단순히 작동하는 프로토타입을 만드는 데서 멈추지 않고, 다른 사람들이 실제로 사용할 수 있는 서비스를 만드는 것이다.
이번 경험을 통해 그 말의 의미를 조금 더 구체적으로 이해하게 되었다.
AI가 만드는 속도를 높여 준다면, 사람은 무엇을 만들지 정의하고 그 결과를 검증하는 역할을 더욱 충실히 해야 한다.
아직 배워야 할 것은 많지만, 이제는 새로운 아이디어가 생겼을 때 ‘코딩을 모르니까 할 수 없다’고 생각하기보다 ‘AI와 함께 어디서부터 시작해 볼까?’라고 질문할 수 있게 되었다.
그것이 이번 도전에서 얻은 가장 큰 변화다. 했던 것과 그 이유를 알려주세요.
(내용 입력)
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.
Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.
Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)



