Zipkok
장소의 제약 없이 집에서 취미를 배우고 공유할 수 있는 비대면 모임 플랫폼
Role
Frontend Developer
Area
로그인·회원가입 기능 구현
2025.09.28 – 진행 중
- TypeScript
- Next.js
- TanStack Query
- React Hook Form
- Zod
- Tailwind CSS
- Jest

프로젝트 소개
온라인 모임에 대한 수요가 증가한다는 점을 고려하여, 집에서도 취미를 공유할 수 있도록 사용자가 모임을 생성하고 참여할 수 있는 비대면 모임 플랫폼을 구현했습니다.
프로젝트 목적
회원가입 과정에서 많은 정보를 한 번에 입력해야 하는 구조는 사용자 피로도 증가와 이탈로 이어질 수 있다고 생각했습니다. 이를 개선하기 위해 퍼널 패턴 UI로 구성하여 단계별 입력 흐름을 설계하는 것을 목표로 했습니다.
주요 구현 사항
- 많은 정보를 입력해야 하는 회원가입 과정의 UX 향상을 위해 퍼널 패턴 UI 및 progress bar 구현
- 단계별로 달라지는 UI에 유연하게 대응하기 위해 합성 컴포넌트 패턴을 적용한 UI 구조 설계
- 퍼널 구조에서 발생하는 입력 상태 관리의 복잡도를 줄이고 불필요한 렌더링을 방지하기 위해 React Hook Form을 활용하여 폼 상태 관리 구조 개선
- Zod를 통해 유효성 검사 로직을 스키마로 분리하고 검증 로직의 재사용이 가능하도록 구조 설계
- 웹과 모바일을 모두 대응하여 동일한 사용 경험을 제공하기 위해 반응형 UI 구현
성과 및 배운점
- 사내 업무 수행 및 유지보수 관점에서 개선 포인트를 고민하고 직접 적용해보며, 운영 효율성과 유지보수성을 함께 고려하는 시각을 기를 수 있었습니다.
- 기능 개선을 통해 사내 직원의 반복 작업으로 인한 불편을 해소하고 업무 효율 향상에 기여했습니다.
1. 퍼널 단계별 레이아웃 차이로 인한 재사용 구조 개선

문제
- 퍼널 단계마다 레이아웃과 버튼 영역이 조금씩 달라 단일 컴포넌트에서 조건문으로 처리할 경우 코드가 복잡해지고 가독성과 유지보수성이 저하되는 문제
기존 접근
- 하나의 컴포넌트에서 조건문을 사용하여 단계별 레이아웃과 버튼을 분기 처리하는 방식으로 구현
- 단계가 추가될수록 조건문이 증가하여 코드 구조가 복잡해지고 가독성과 유지보수성이 저하되는 구조적 한계 존재
해결
- 단계별로 달라지는 레이아웃과 버튼 영역에 유연하게 대응할 수 있도록 컴포넌트 조합 방식의 합성 컴포넌트 패턴을 적용하여 구조 개선
- props를 통해 단계별 레이아웃과 버튼 영역을 제어할 수 있도록 설계하여 재사용 가능한 구조로 개선
- 조건문 분기 방식에서 컴포넌트 조합 방식으로 변경하여 코드 복잡도를 낮추고 유지보수성과 확장성을 고려한 구조로 개선
회고
- 퍼널 UI 구조를 설계하는 경험을 통해 변경과 확장을 고려한 컴포넌트 구조 설계가 유지보수에 중요하다는 점을 이해하고, 컴포넌트 조합 방식의 구조 설계 역량을 기를 수 있었습니다.
- 추후에는 합성 컴포넌트 구조를 기반으로, 공통 컴포넌트 간 상태를 공유할 수 있는 구조 설계 방식도 적용해보고자 합니다.