집중 타이머 (Focus Timer)
토스 앱에서 별도 설치나 로그인 없이 사용할 수 있는 집중 타이머를 기획하고 출시했습니다. 시간 계산과 상태 전환을 설계하고, 기기별 화면 개선과 실기기 검증을 거쳐 1.0.1 업데이트를 배포했습니다.
- 참여 기간
- 2026.09 – 진행 중
- 담당 역할
- 개인 프로젝트 기획 · React Native 개발 · 기기별 QA · 앱인토스 출시 및 릴리즈 관리
- TypeScript
- React
- React Native
- Apps-in-Toss Framework
- Granite
- TDS React Native
- SVG
- React Native Animated
- Jest
- React Native Testing Library
- Maestro
- ADB
- Xcode iOS Simulator
- ESLint
- GitHub
- Codex
핵심 기여
- 종료 예정 시각 기반 시간 계산과 준비·실행·중단·완료 상태 전환 설계
- 앱 이탈 시 남은 시간 보존과 사용자 선택에 따른 재개 흐름 구현
- TDS 공통 UI와 화면 가용 높이를 반영한 타이머·입력 영역 구성
- 완료 햅틱·애니메이션 및 숫자 크기·중앙 배치 개선
- 자동화 테스트와 실제 토스 앱 검증을 거쳐 출시·1.0.1 업데이트 배포
프로젝트 개요
공부나 작업을 시작할 때 시간을 정하고 한 가지 일에 집중할 수 있도록, 토스 앱 안에서 사용하는 집중 타이머를 기획하고 개발했습니다. 별도 앱 설치나 로그인 없이 30·60·90분을 선택하거나 1~180분을 직접 입력해 바로 시작할 수 있습니다.
첫 버전은 시간을 설정하고 집중을 시작한 뒤, 필요할 때 중단하거나 다시 이어가는 흐름에 집중했습니다. 앱을 벗어나면 남은 시간을 보존하고, 돌아온 사용자가 직접 재개하도록 사용 정책을 정했습니다.
2026년 2월 초기 구현을 시작하고 9월에 출시 범위와 기기별 검증을 정리했습니다. 첫 출시 이후 사용자 피드백을 반영해 화면을 개선했으며, 2026년 9월 26일 1.0.1 업데이트를 공개했습니다.
주요 기능
- 집중 시간 설정: 30·60·90분 빠른 선택과 1~180분 직접 입력.
- 타이머 실행: 남은 시간과 진행률 표시, 중단·재개·종료 및 완료 후 다시 시작.
- 앱 이탈 처리: 홈 이동이나 화면 잠금 시 자동 중단하고 남은 시간 보존.
- 완료 피드백: 햅틱과 숫자 애니메이션으로 집중 종료 안내.
- 화면 구성: TDS 기반 확인창, 화면 높이에 따른 타이머 크기 조절과 키보드 대응.
주요 작업
1. 시간 계산과 타이머 상태 전환 설계
시간 선택부터 실행·중단·재개·완료까지 화면과 남은 시간이 같은 기준으로 움직이도록 구성했습니다. 타이머는 ready / running / paused / completed 상태로 나누고, 상태 전환과 종료 예정 시각을 useFocusTimer에서 관리했습니다.
시간 계산에는 매번 1초씩 차감하는 방식 대신 종료 예정 시각과 현재 시각의 차이를 사용했습니다. 실행 중에는 250ms 간격으로 남은 시간을 갱신해 콜백 지연이 누적되는 영향을 줄이도록 설계했습니다. 시간 포맷과 입력 검증은 유틸리티로 분리했습니다.
앱이 백그라운드로 이동하면 남은 시간을 보존한 채 중단하고, 복귀 후 사용자가 직접 이어서 시작하도록 구현했습니다. 종료를 확정하면 설정 시간으로 초기화하고, 중단 상태에서는 시간 변경을 제한해 진행 중인 세션의 기준을 유지했습니다.
훅·유틸리티 테스트와 기기 테스트로 시작·중단·재개·종료 및 완료 경계 동작을 확인했습니다. Galaxy S25에서는 화면 잠금 후에도 자동으로 재개되지 않고 중단 상태를 유지하는 흐름을 검증했습니다.
2. TDS 기반 공통 UI와 화면 크기 대응
기기마다 다르게 표시되던 기본 확인창을 TDS 공통 다이얼로그로 정리했습니다. EndSessionDialog에 취소·종료와 Android 뒤로 가기 동작을 모아 종료 확인 흐름을 일관되게 구성했습니다.
작은 화면이나 키보드가 열린 상황에서도 조작할 수 있도록 본문과 하단 버튼 영역을 나누었습니다. 화면과 제목·설정·설명 영역의 높이를 측정해 원형 타이머의 지름을 160~260dp 범위에서 계산하고, 공간이 부족하면 스크롤로 내용을 확인하도록 했습니다.
커스텀 입력은 준비 상태에서 표시하고 KeyboardAvoidingView, 하단 여백과 접근성 라벨을 적용했습니다. 개발 과정에서 iOS 시뮬레이터, Android 에뮬레이터와 S25로 화면을 확인했으며, S25에서는 180분 입력, 키보드 열기·닫기, 큰 글씨 설정과 하단 버튼 접근을 점검했습니다. TalkBack의 기본 역할·라벨·선택 상태와 버튼 음성 안내도 확인했습니다.
3. 집중 완료를 전달하는 피드백 구성
완료를 더 쉽게 알아차릴 수 있도록 햅틱과 시각적 피드백을 함께 구성했습니다. 실기기에서 초기 진동이 약하게 느껴진다는 피드백을 바탕으로, 플랫폼의 success 햅틱 패턴을 최대 5회 요청하도록 개선했습니다.
useCompletionHaptics에서 응답 후 1.1초 간격으로 다음 요청을 예약하고, 숫자에는 회전·좌우 이동 애니메이션을 적용했습니다. 앱이 비활성화되거나 컴포넌트가 정리되면 예약과 애니메이션을 취소해 효과의 실행 시점을 관리했습니다. 햅틱 호출에 오류가 발생해도 타이머는 정상적으로 완료 상태를 유지하도록 처리했습니다.
테스트로 햅틱 호출과 취소 동작을 확인하고, S25에서 완료 화면과 다시 시작하는 흐름을 점검했습니다. 개발 중 실기기 피드백을 통해 개선된 진동이 이전보다 뚜렷하게 전달되는 것도 확인했습니다.
4. 출시 후 피드백을 반영한 숫자 표시 개선
첫 출시 이후 iPhone 13 Pro에서 첫 화면의 30:00이 작게 표시되고 중앙에서 벗어나 보인다는 피드백을 받았습니다. 이에 초기 레이아웃 측정과 자동 글자 축소의 영향을 고려해, 타이머 숫자의 크기와 배치를 명시적으로 계산하는 방식으로 개선했습니다.
adjustsFontSizeToFit 의존성을 제거하고 원 지름과 시간 문자열 길이에 따라 글자 크기·행 높이를 계산했습니다. 원 컨테이너와 텍스트 오버레이의 크기를 지정해 중앙 배치 기준을 맞췄습니다. 숫자는 별도의 크기 정책을 적용하고 주변 설명과 접근성 시간 안내는 유지했습니다.
중단 버튼에는 TDS danger 색상을 적용해 시작·재개 동작과 시각적으로 구분했습니다. S25의 실제 토스 앱에서 30·60·90분과 커스텀 180분, 1분 완료·재시작을 확인했습니다. 앱을 강제 종료한 뒤 같은 번들로 세 차례 재진입해 첫 화면의 숫자 크기와 중앙 배치를 검증하고, 해당 개선을 1.0.1에 반영했습니다.
5. 자동화 테스트부터 실제 앱 출시까지 연결
타이머 로직과 화면 흐름, 실제 배포 번들을 단계별로 확인할 수 있도록 검증 기준을 정리했습니다. Jest 테스트와 Maestro 시나리오, 실기기 관찰을 함께 사용하고 스크린샷·접근성 트리·JUnit 결과를 기록했습니다.
입력 경계값, 빠른 연속 조작, 홈 이동·잠금 후 복귀, 종료 다이얼로그와 완료 흐름을 점검했습니다. 1.0.1에서는 타입 검사·린트·Jest 32개 테스트·AIT 빌드를 통과했고, USB 개발 서버 포트 연결을 제거한 상태에서 S25의 실제 토스 앱으로 배포 번들을 확인했습니다.
앱 정보·로고·노출 이미지 등록부터 영문 앱명 심사 피드백 반영, 번들 업로드·검토 요청·출시까지 진행했습니다. 공개 번들 20260926-5와 GitHub PR #3, v1.0.1 릴리즈를 연결해 어떤 변경이 출시되었는지 추적할 수 있도록 정리했습니다.
개발 과정
개발·문서화·테스트 자동화 과정에서 Codex를 활용했습니다. 사용 흐름과 출시 범위를 정리하고, 실기기에서 확인한 피드백을 구현과 검증 항목에 반영하며 첫 출시와 후속 업데이트까지 진행했습니다.
관련 자료
토스 앱에서 집중 타이머로 제공하며, 앱 식별자는 devyne-timer-app입니다.
아래 개발·출시 자료는 저장소 접근 권한이 있는 경우 확인할 수 있습니다.