본문으로 건너뛰기

내 사이트가 안 바뀌었어요 — 로컬·GitHub·배포, 3단계를 헷갈렸던 하루

부기부기

2026.07.25

## 한 줄 요약

로드맵을 다 만들었는데 실제 사이트엔 안 보여서 한참 헤맸어요. 알고 보니 "내 컴퓨터에서 미리보기"와 "인터넷에 진짜 올라간 사이트"는 완전히 다른 곳이었고, 그 사이를 GitHub과 Vercel이 이어주고 있었어요.

## 누구에게 도움이 될까

- 학습메이트한테 "이거 만들어줘"를 시켜서 파일은 생겼는데, 실제 사이트(배포된 주소)엔 안 보여서 당황한 적 있는 분

- "로컬", "커밋", "푸시", "배포"라는 말이 다 따로따로 들려서 뭐가 뭔지 헷갈리는 분

## Before — 이런 상황이었어요

4주 로드맵을 인터뷰로 완성하고 "위키에 저장했어요, 미리보기에서 확인해보세요"라는 말을 들었어요. 그런데 제가 실제로 열어본 건 https://learning-hub-template.vercel.app — 진짜 인터넷 주소였는데, 거기엔 로드맵이 안 보였어요. "분명 만들었다고 했는데 왜 없지?" 싶어서 답답했어요.

## 어떻게 했나 — 실제 대화

이렇게 물어봤어요:

```

https://learning-hub-template.vercel.app/ 여기엔 없잖아 ㅠㅠ

```

막힘: 여기서 저는 "로컬 미리보기(localhost:4321)"랑 "실제 배포된 사이트(.vercel.app 주소)"가 같은 건 줄 알았어요. 그런데 순이가 확인해보니, 로컬엔 있는데 배포 사이트엔 없었어요.

해결 — 순이가 설명해준 구조:

| 단계 | 뭐하는 곳 | 언제 바뀌나 |

|---|---|---|

| ① 로컬 (localhost:4321) | 내 컴퓨터 안에서만 보이는 임시 미리보기 | 파일 저장하면 바로 반영 |

| ② GitHub | 코드를 저장해두는 온라인 창고 | 커밋 + 푸시를 해야 반영 |

| ③ Vercel (.vercel.app 주소) | 실제로 남들이 보는 배포된 사이트 | GitHub이 바뀌면 자동으로 감지해서 새로 만듦 |

즉 로컬에서 파일을 만드는 것만으로는 부족하고, "GitHub Desktop에서 커밋 → Push" 버튼까지 눌러야 그게 GitHub에 올라가고, 그걸 Vercel이 알아서 가져다가 실제 사이트를 다시 만들어줘요.

그다음 GitHub Desktop을 열어서, 아래 순서로 진행했어요:

1. 변경된 파일 목록 확인 (이번엔 00-roadmap.md 등 3개 파일)

2. Summary 칸에 짧게 메시지 쓰기

3. "Commit 3 files to main" 클릭

4. "Push origin" 클릭

막힘 2: 이 과정을 채팅으로 하나하나 확인하면서 진행하다 보니, 코드로 직접 하는 것보다 "지금 뭐가 어디 상태인지"가 눈에 잘 안 보여서 훨씬 답답하게 느껴졌어요. 화면 캡처를 여러 번 주고받으며 겨우 상황을 맞춰갔어요.

## After — 결과

Push 이후 1~2분 기다렸다가 실제 배포 주소에서 다시 확인하니, 로드맵이 정상적으로 떠 있었어요. "로컬 → GitHub → Vercel" 3단계가 순서대로 이어진다는 걸 몸으로 이해하고 나니, 다음부터는 "왜 안 바뀌지?" 하고 당황하지 않고 "아, 아직 커밋·푸시를 안 했구나"를 바로 떠올릴 수 있게 됐어요.

## 배운 것 / 재사용 자산

기억할 3단계: 로컬(내 컴퓨터, 즉시 반영) → GitHub(커밋·푸시해야 반영) → Vercel(자동 배포, 1~2분 소요).

사이트에 변화가 안 보일 때 체크리스트:

1. 로컬 미리보기(localhost)에서는 보이나요? → 안 보이면 파일 자체를 다시 확인

2. GitHub Desktop에서 커밋·푸시를 했나요? → 안 했으면 지금 하기

3. 푸시한 지 1~2분 지났나요? → Vercel이 새로 만드는 시간이 필요해요

오늘의 솔직한 마음: 채팅으로 진행하다 보니 중간 상태가 눈에 안 보여서 실제 코드 작업보다 더 답답하고 힘들었어요. 그래도 한 번 겪고 나니 다음엔 훨씬 수월할 것 같아요.

8

함께 이야기해요 8

로그인하고 댓글을 남겨 주세요

유피테르 프로필 이미지
유피테르2026.07.28

변경된 파일 3개를 직접 확인하고 커밋과 Push까지 차근차근 진행해 실제 배포 주소에 로드맵을 띄운 과정이 정말 인상적이에요. 화면 캡처를 주고받으며 중간 상태를 하나씩 맞춰간 경험을 솔직하게 기록해 주셔서, 비슷한 상황에 놓인 분들이 어디에서 막혔는지 훨씬 쉽게 이해할 수 있겠습니다. 마지막에 사이트가 바뀌지 않을 때 확인할 체크리스트까지 정리해 두신 덕분에 한 번의 시행착오가 재사용 가능한 기준으로 남았네요.

아루나 프로필 이미지
아루나2026.07.26

이해가 안 되셨다고 하지만 어쩌면 그래서 더 이해를 하려고 노력하셔서 그런지 오히려 더 잘 이해하시고 작업을 하신 거 같다는 느낌이 듭니다 만약에 앞으로도 작업하시는데 이해가 안 되신다면 차라리 그 커리큘럼 페이지를 복사해서 클로드한테 주고 더 쉽게 설명해 달라고 하면은 아주 쉽게 설명해 준답니다. 그리고 아래 링크는 제가 전기수에 작업했던 바이브 코딩에 대한 개념을 시나리오 형식으로 풀어낸 자료입니다 이걸 참고하시면 좀 더 이해가 되실지 모르겠네요.https://study-hub-eta-olive.vercel.app/onboarding/concept/

부기부기 프로필 이미지
부기부기2026.07.26

와 감사합니다!!ㅎㅎ 참고햐보겠습니다~ 지금은 제가 해놓고도 뭘했는지도 모르는 지경이네요

체이스 프로필 이미지
체이스2026.07.26

저도 가이드를 따라 하기만 해서 되니까, '와우 되었네 !' 하고 좋아했지만, 개념 이해 없는 상태에서 따라하기만 한거라 뭘 한건지 이해가 부족했는데, 덕분에 ' 로컬 → GitHub 업로드 → Vercel 로 배포 ' 개념이 좀 더 명확해 졌네요. 감사해요 - 👍

제이리 프로필 이미지
제이리2026.07.25

부기부기님 아까 열심히 클로드와 대화하시던 모습이 기억 납니다!
로드맵 파일은 잘 옮기셨나요? 혹시 안되었다면 클로드 [코드]에서 한번 더 로드맵을 작성하면서 구체화해도 좋을 것 같단 생각도 들었습니다~!

그리고 나만의 AI비서 또는 카드지출내역 관리 자동화처럼 기능 하나에만 집중해보시고 고도화하는 것도 좋을 것 같구요

앞으로 하루씩 챌린지 같이 하면서 완주 끝까지해보아요~!! ^^

부기부기 프로필 이미지
부기부기2026.07.26

좋은 의견 감사합니다. 사실 아까 반영하려고 했는데 사이트 업로드까지 너무 지쳐서 그 부분에 고치지 못했어요ㅎㅎ

부기부기 프로필 이미지
부기부기2026.07.26

감사합니다ㅎㅎ 스터디 쫓아가는 것만 해도 은근 힘이 드네요

제이리 프로필 이미지
제이리2026.07.27

@부기부기

부기부기님 화이팅이에요! ❤️ 바쁘신 일정에 스터디 완주만으로도 대단한 거라서요 같이 완주해보아요!!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기