웹·앱을 기획부터 배포까지 진행기록
2026.08.11
소개
PERI-LUNE(눈가연구소)은 특허 기반 뷰티 디바이스 + 교체형 앰플 카트리지 + 앱을 연결하는 스킨케어 브랜드입니다. 저는 이 서비스의 웹 마케팅 사이트( perilune.app)와 실사용자용 모바일 앱을 동시에 만들어야 했습니다. 특허 기반 뷰티 디바이스는 시제품을 협의하는 단계로 그 전에 마케팅 사이트를 홍보용으로 만들어보려 했으나 여러가지 기획이 꼬였습니다.
일단 디바이스 제작전에 웹과 앱 기획-디자인-개발-배포-인프라(도메인·OAuth·결제)까지 전 과정을 진행해보기로 했습니다. 로긴부터 카카오톡과 라인 구글이 한번에 잘 안었고 hermes와 codex claude code로 3가지 버전을 동시에 진행하였고 codex와 hermes는 진행하다 요청사항이 잘 수행이 안되서 중단하고 claude code를 vs code에 적용하여 끝까지 끌고갔습니다.
구글로그인에서 계속 막혀 찍어서 보여주면 원인을 찾고, 막히면 다음 액션을 제안받고, 실제 배포까지 그 자리에서 확인하는 방식으로 web을 먼저 만들고 이후 app을 만들어 배포하고 사이트 url을 구매하여 배포하였습니다.
진행 방법
사용한 도구
Claude Code (CLI 에이전트) — 코드 작성/수정, 터미널 명령 실행(빌드·배포·DNS 확인), 스크린샷 촬영·분석까지 처리
Vercel — 웹 배포, 커스텀 도메인(perilune.app, perilune.kr, perilune.co.kr, peri-lune.com) 연결
Supabase — 로그인(OAuth), 결제 승인, DB, Edge Function
ffmpeg — 실사 이미지 리사이즈/압축, 영상 포스터 프레임 추출
Expo — 모바일 앱 개발 서버 (Expo Go 와
--web모드로 브라우저 테스트)
실제로 어떻게 굴러갔는지 — 예시 3가지
1) PRD 짜기
서비스 구현을 위한 PRD에 많은 시간이 들였고 실제 개발진행은 간단하게 진행
아래 app기능정의서를 참고해 첨부한 app기능을 구현해주세요
이 파일을 APP폴더에 넣었으니 수정해주세요.
Claude Code가 문서를 직접 읽고, 기존 코드 구조(CSS 클래스, 컴포넌트 재사용 패턴)를 먼저 파악한 뒤, 히어로 카피부터 "두 가지 특허" 같은 개수 제한 문구 제거, 3카드 포트폴리오 재구성, 7단계 플로우 추가까지 한 번에 반영하고 빌드 확인 후 배포까지 진행
2) 카카오 로그인 디버깅 — 스크린샷으로 원인 찾기
Supabase에 카카오 로그인을 붙이는데 계속 에러 에러 화면을 캡처해서 보여주기만 하면:
KOE004→ "카카오 로그인 사용 설정이 꺼져있다" → 활성화 위치 안내KOE205→ "이메일 동의항목 권한이 없다" → 카카오 내장 Provider 대신 Custom OAuth Provider로 전환, 이메일 없이 닉네임만으로 로그인되게 구조 자체를 바꿈KOE006→ "리다이렉트 URI 미등록" → 최신 카카오 콘솔에서 위치가 바뀐 걸 찾아냄 (카카오 로그인 메뉴가 아니라 플랫폼 키 → Default REST API Key 안에 있었음)
이렇게 실제 화면을 반복해서 주고받으며 원인을 좁혀가는 방식으로 해결
3) 모바일 앱 — BLE 이벤트 설계 + AI 대화 기능
디바이스 제조사 미팅 후 "시제품이 나오면 바로 테스트 가능하게 만들어달라"는 요청
lib/ble.ts — 디바이스가 보내야 할 BLE 이벤트 계약(스펙)을 타입으로 고정.
지금은 MockBleTransport로 시뮬레이션하고, 실기기 SDK가 오면
RealBleTransport 하나만 같은 인터페이스로 만들어 갈아끼우면 됨.
즉 "일단 되게 만들기"가 아니라, 나중에 실제 하드웨어가 왔을 때 한 줄만 바꾸면 되는 구조로 설계해줬습니다. 여기에 카트리지 대화 상담 기능("루네")을 진짜 텍스트만 되풀이하던 가짜 챗봇에서 Claude API로 실제 대화하는 기능으로 업그레이드하고, 캐릭터 아바타 이미지까지 채팅창에 붙였습니다.
캡처 화면
화면 | 설명 |
|---|---|
01-웹-홈-히어로.png | 웹 홈페이지 — 실사 디바이스 이미지 적용, 잘림 없이 표시되도록 수정한 버전 |
02-웹-공식몰-결제섹션.png | 공식몰 — 사전예약금 결제 섹션 (Toss/Stripe 연동) |
03-웹-챌린지페이지.png | #PeriLuneChallenge 업사이클링 이벤트 페이지 |
04-웹-아카이브-코스믹비주얼.png | 하루 루틴이 쌓이는 걸 표현한 코스믹 비주얼 (반복 피드백으로 여러 번 갈아엎은 결과물) |
05-앱-루네AI챗+캐릭터.png | 모바일 앱 — Claude API 연동 대화 + 캐릭터 아바타 적용 후 |
결과와 배운 점
배운 점 / 나만의 꿀팁
말로 설명하지 말고 캡처를 보여주기 특히 OAuth 콘솔처럼 UI가 계속 바뀌는 외부 서비스는, 화면을 그대로 보여주면 정확한 버튼 위치도 알려줌
"일단 되게" 말고 "나중에 실제 업데이트 시 안 갈아엎게"를 먼저 요청
결제처럼 되돌리기 힘든 작업은 진행 전에 꼭 확인받는 흐름
채팅에 붙여넣은 이미지는 AI가 직접 파일로 저장하지 못한다는 것
— "다운로드 폴더에 저장 → 파일명만 알려주기" 흐름으로 우회했습니다.
시행착오
네이버 Client ID 불일치, 카카오 리다이렉트 URI 위치처럼 외부 콘솔 UI가 자주 바뀌어서 여러 차례 스크린샷을 주고받아야 했습니다.
WEB와 모바일 APP이 다른 버전은 APP을 별도 Expo Go 진행 시 SDK 버전 불일치로 QR 스캔이 안 됐던 적이 있습니다 →
expo start --web으로 전환해서 해결.개발 서버 캐시가 꼬여서 CSS가 안 뜨는 문제를 몇 번 진짜 버그로 오해했다가,
.next캐시 삭제로 매번 해결됐습니다.
도움이 필요한 부분
Toss/Stripe 실 결제 키, Supabase Edge Function 배포는 로그인 권한이 필요해 사용자가 직접 마무리해야 하는 구간
앞으로의 계획
디바이스 제조사 시제품 도착 시 Mock BLE → 실제 하드웨어 SDK 교체
루네 챗봇에 성분표/피부 사진 분석(Vision) 기능 추가
가격 확정 후 웹·앱 상품 데이터 통합


