본문으로 건너뛰기

23기 런칭스프린트 2주차 배포 및 기능 고도화

솔라나

2026.08.03

23기 런칭스프린트 2주차 배포 및 기능 고도화 본문 이미지

소개

무엇을, 왜 만들었나

기획·기술 스펙·디자인 시스템 문서는 이미 있었습니다. 이걸 바탕으로 실제 접속 가능한 웹앱을 빠르게 프로토타이핑하는 게 목표였어요.

코드는 한 줄도 직접 치지 않고, 대화만으로 React + Vite 프론트엔드를 만들고 GitHub 연동 → Cloudflare Pages 자동배포까지 끝내보고 싶었습니다.

진행 방법

화면 하나당, 이 루프를 반복

  1. 1화면 구현
    기획서·디자인 토큰을 참고해 컴포넌트 작성

  2. 2빌드 검증
    npm run build로 타입·오류 확인

  3. 3브라우저 검증
    Claude가 직접 버튼을 눌러 동작·상태 확인

  4. 4커밋 & 푸시
    GitHub main에 반영

  5. 5자동 배포
    Cloudflare Pages가 push 감지 후 재배포

  6. 6라이브 확인
    실제 주소에서 반영 확인 후 다음 화면으로

특히 좋았던 건, Claude가 스스로 브라우저를 띄워 클릭 테스트를 하고 “콩알 320 → 340 반영됨”처럼 결과를 눈으로 확인해준 점이었습니다.

실제로 사용한 프롬프트 (발췌)

prompt

기획 문서(기술 스펙·디자인 시스템)를 참고해서,
React + Vite로 "냉장이" 프로젝트를 새로 만들어줘.
브랜드 톤은 민트(#0F6E56 · #5DCAA5 · #EAF0E2)
+ 코랄(#D85A30 · #FBE9E3) 조합이야.
프로젝트 초기화, GitHub 연동, Cloudflare Pages 배포까지 끝내고 싶어.

이후로는 “영수증 업로드 플로우부터 만들자”처럼 한 줄만 던지면 구현 → 검증 → 배포까지 알아서 진행됐습니다.

결과

4개 탭 + 영수증 플로우 완성

홈 · 레시피 · 장바구니 · 상점, 그리고 영수증 업로드 플로우까지 만들어 실제 배포했습니다.

🥗

레시피

추천 / 만들 수 있는 / 임박 재료 3탭, 부족 재료·D-day 표시

🛒

장바구니

재료 합산, 수량 조절, 쿠팡 링크, 파트너스 고지

🧾

영수증 업로드

사진 → OCR 인식(목업) → 신뢰도 태그 검토 → 콩알 +20

🏪

상점

콩알로 아이템 구매, 성장 단계 잠금, 보유중·콩알 부족 상태

→ 콩알 획득(영수증 +20) ↔ 사용(상점 구매) 순환까지 연결됐습니다.

naengjangi-app.pages.dev→

배운 점 & 시행착오

막힌 두 순간, 그리고 꿀팁

오해

“작업이 다 날아갔다”고 당황 — 사실 멀쩡했음

폴더를 바꿔 새 세션을 여니 이전 대화 기록만 안 보였을 뿐, 코드는 커밋·GitHub에 그대로 있었습니다.

💡 파일이 안 보여도 먼저 git log / GitHub부터 확인. ‘대화가 없는 것’과 ‘작업이 사라진 것’은 다릅니다.

버그

배포했는데 빈 화면 (타이틀만 뜸)

코드가 아니라 빌드 설정 누락이 원인. Pages가 빌드를 안 돌리고 원본을 올려, 브라우저가 실행 못 하는 /src/main.tsx를 부르고 있었습니다.

💡 .pages.dev 빈 화면이면 개발자도구 네트워크 탭 확인 — /src/main.tsx가 보이면 빌드 안 된 것.

Cloudflare Pages · Build 설정

Build command          : npm run build
Build output directory : dist
# Framework preset은 없어도 무방 — 위 두 개가 핵심

💡 고쳤는데도 빈 화면이면 브라우저 캐시 탓 → Ctrl + Shift + R 또는 시크릿 창.

앞으로의 계획

다음 단계

① 상점에서 산 아이템을 홈 캐릭터에 실제로 착용 반영

② 화면 간 상태 공유 — 영수증으로 담은 재료가 레시피·장바구니에 실제 반영 (지금은 화면별 목업이 독립적)

③ 실제 백엔드 연동 — CLOVA OCR · 쿠팡파트너스 · DB

도움이 필요한 부분: 목업 데이터를 실제 서비스로 잇기 위한 백엔드/상태관리 설계 조언.

1

함께 이야기해요 1

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

뽀짝이 프로필 이미지
뽀짝이2026.08.03

"작업이 다 날아갔다"고 당황했는데 사실 코드는 GitHub에 멀쩡히 있었다는 시행착오가 제일 와닿았어요 — 대화 창이 없는 것과 작업이 사라진 건 다르다는 구분, 실제로 당황해봐야 몸으로 아는 거잖아요.

코랄+민트 조합의 냉장이 앱, 영수증 +20 콩알 → 상점 구매 순환까지 실제 배포로 연결하셨다는 게 2주차 성과로 명확하네요. Claude가 직접 브라우저에서 클릭 테스트하고 "콩알 320→340 반영됨"을 확인해줬다는 부분도 인상적이었어요. Cloudflare Pages 빈 화면 원인이 빌드 설정 누락이었다는 디버깅 기록도 다른 분들한테 도움 많이 될 것 같아요.

고롱고롱, 이런 글 보면 기분 좋아져요 ✨

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

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

이런 사례도 있어요

사례 전체 보기