클로드 코드로 스크롤 따라 움직이는 토스 미니앱 소개 화면 만들기
서인
2026.10.08

2026년 10월 8일, 클로드 코드(Claude Code)로 토스 홈페이지처럼 스크롤하면 움직이는 미니앱 소개 화면을 만들었어요. 신입 직장 매너 사전 앱의 목업이에요
## 재미없는 앱은 만들기 싫었어요
평범한 회사원인 지피터스 24기 토스미니앱 멤버 서인이에요. 직장 내 예절에 대한 책을 쓰면서 이 앱을 떠올렸어요. 선후배끼리 말 한마디에 속상해하고 오해하는 일이 많은데, 저는 자기객관화로 그 오해를 푼 경험이 있었어요. 그 경험을 바탕으로 스터디 과제 앱을 만들기로 했고, 사회초년생이 모르고 하는 직장 실수를 알려 주는 매너 사전을 골랐어요. 선배가 후배에게 "너 이거 한번 봐" 하고 보내 주는 경로도 같이 생각했어요.
클로드 코드에 처음 보낸 말은 이랬어요.
```
꼰대 지침서를 토스 미니앱에서 만들고 싶어 직장내에서 세대차이 견해차이로 생기는 오해를 상처받지 않고 해결할수 있는 소통앱이였으면 좋겠어
```
처음엔 꼰대 지침서였는데, 기획 문서에는 "꼰대 지침서로 읽혀 반발"할 위험을 적어 두고 후배를 기죽이지 않는 쪽으로 방향을 잡았어요. 그 결과가 신입 매너 사전과 선배 입장도 담은 앱이에요.
그런데 매너 사전이라고 하면 딱딱한 목록이 떠올라서, 앱을 처음 여는 순간부터 재미없으면 안 된다고 생각했어요.
## 토스 홈페이지의 스크롤을 내 앱에
고민하다가 토스 공식 홈페이지를 레퍼런스로 삼았어요. 스크롤하면 화면이 움직이는 홈페이지가 눈에 들어왔고, 이걸 내 미니앱에 넣고 싶었어요. 지금 만든 목업이 바로 그 시도예요. 크게 막힌 곳은 없었어요.
## 스크롤 위치 하나로 장면 넷을 움직인 방법
앱을 열면 4장면 소개가 나와요. 신입 눈, 선배 눈, 아무도 말 안 해줌, 앱 소개 순서예요. 스크롤하는 만큼 장면이 바뀌고, 건너뛰기 버튼도 있어요.
코드에서는 스크롤한 위치를 0에서 1 사이 숫자 하나로 바꿔요. 이 숫자 하나로 아래 네 가지를 한꺼번에 정해요.
- 장면마다 투명도, 위아래 위치, 크기
- 배경색: 노란빛에서 푸른빛으로 천천히 바뀌어요
- 걷는 사람의 가로 위치: 화면 왼쪽에서 오른쪽으로 가요
- 아래쪽 진행 막대의 길이
걷는 사람은 처음엔 🚶이다가 중간을 넘으면 😶, 끝에 가까워지면 🙂로 바뀌어요. 선배 눈에는 마감이 코앞인데 이제 말하는 신입이 어떻게 보일지 보여 주다가, 마지막에 "아무도 먼저 알려주지 않아요"로 끝나는 흐름이에요.
▲ 스크롤 소개 두 번째 장면. 걷는 이모지가 진행 막대 위를 가고 있어요

▲ 장면이 넘어가는 중간. 글자가 옅어지고 있어요
소개 이야기는 다섯 세트(퇴근 인사, 질문하기, 답장 "넵", 점심 거절, 선배의 농담)가 3일마다 바뀌어요. 위 스크린샷은 질문하기 세트예요.
## 걷는 이모지를 손본 네 번의 커밋
제가 바란 건 스크롤을 올리고 내릴 때 이모지가 앞으로 걸어가는 느낌이었어요. 처음엔 이모지가 거꾸로 서 있었어요. 코드 주석에는 🚶가 왼쪽을 보는 기기가 많다고 적혀 있어요. 그래서 17시 31분 커밋에서 걷는 구간만 좌우를 뒤집었고, 스크롤 방향에 따라 내리면 오른쪽으로 걷고 다시 올리면 왼쪽을 보게 했어요.
그 사이에 이모지를 SVG 선 아이콘으로 바꿨다가(17시 9분) 6분 만에 이모지로 되돌린(17시 15분 "이모지 복원, 걷는 방향 보정") 일도 있었어요. 위 스크린샷의 걷는 사람이 그 이모지예요. 17시 17분에는 터치 기기에서 "위로 밀어 보세요" 안내가 나오게 했어요.
## 클로드 코드로 이어 붙인 사전과 티모드
소개가 끝나면 매너 사전이 나와요. 상황을 고르면 판정(괜찮아요, 조심해요, 하지 마요)과 이유, 대신 이렇게 하라는 말이 이어져요. 마지막 커밋에서 사전을 38개로 늘렸어요. 정답을 단정하지 않으려고 "대부분의 직장 기준이에요. 회사와 팀마다 다를 수 있어요"라는 문구를 붙였고, 근거를 확인하기 전이라 "초안 · 근거 확인 전" 표시도 달았어요.
> 선배 메시지를 읽고도 답을 하지 않는다 (하지 마요)
> 보낸 사람은 읽었는지, 할 수 있는지 알 수 없어서 불안해져요.
> 대신 이렇게: "확인했습니다. 오후까지 답드리겠습니다."라고 먼저 짧게 답하세요.

▲ 매너 사전 상세 화면
사전 상세 맨 아래의 "이 일로 속상해요 → 티모드" 버튼을 누르면 티모드로 넘어가요. 선배·상사 때문에, 후배 때문에, 동료·동기 때문에 중 입장을 고르고, 감정과 사실을 나눠 적으며 한 걸음 떨어져 보는 기능이에요. 치료나 진단이 아니라 생각 정리 도구라는 원칙을 문서에 적었고, 1차 버전은 AI도 서버도 로그인도 없이 기기 안에서만 돌아가요.

▲ 티모드 첫 화면
아직 제목을 정하지 못했어요 MBTI의 T성향이 자기객관화 할때는 쉽더라 라는 경험으로 티모드라는 배너 제목이 나왔어요
## 아직 안 된 것
아직 완성이 아니에요. 써 본 사람도 아직 없어요. 컴퓨터를 오가며 수정해야 해서, 어쩔 수 없이 먼저 배포해 뒀어요. 직접 눌러 볼 수 있는 주소는 https://jamkkan-t.vercel.app 이에요. 실제 토스 미니앱(앱인토스)에 올린 건 아니고, 인앱 광고도 목업에서는 숨겨 뒀어요.
앱 이름도 정하지 못했어요. 임시로 "이거 해도 돼?"를 쓰고 있어요. 사전 내용의 근거 확인, 위기 상황 안내 문구, 티모드라는 기능명을 계속 쓸지, 토스 검색에서 비슷한 직장 매너 앱이 있는지도 문서에 열린 질문으로 남아 있어요. 사전은 처음 목표로 잡은 30개에서 50개 가운데 38개까지만 채웠어요.

![토스 미니앱 스터디 2주차 기록 · 아이언 [기억정원, 토스 앱에서 처음 열리다] 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F887d253f860fd22c762b4d21.jpg&w=3840&q=75)


꼰대 지침서로 시작했다가 후배를 기죽이지 않는 매너 사전으로 방향을 트신 과정이 좋았어요.
판정 뒤에 대부분의 직장 기준이고 팀마다 다를 수 있다는 문구를 붙이신 건 이 앱에 꼭 필요한 한 줄 같아요.
티모드라는 이름도 입에 잘 붙는데, 제목 정해지면 알려 주세요.