김재현

Frontend Engineer

링크드인:
www.linkedin.com/in/harryk-im
깃허브:
github.com/harryk-im
웹 포트폴리오:
harryk.im
기술블로그:
hanyugeon.tistory.com
이메일:
hanyugeon@naver.com

"사용자 경험과 개발 생산성을 함께 개선하는 프론트엔드 엔지니어"

경력

Toss

Interaction Team / Frontend Developer Assistant

사내 디자인 에디터에서 인터랙션 라이브러리를 활용할 수 있도록 개발된 플러그인의 기능 개발과 E2E 검증 체계를 구축했어요.

  • React
  • TypeScript
  • React-Query
  • Emotion
  • Playwright

제약을 고려한 E2E 테스트 자동화

E2E 테스트 자동화 도중 마주했던 "문제"와 "선택" 그리고 "개선" 과정을 경험했어요

  1. 01 / 제약

    외부 CI 사용 불가

    사내 보안 정책으로 내부 시스템과 외부 CI를 연동할 수 없었어요

  2. 02 / 선택

    로컬 품질 게이트 활용

    Husky pre-push 훅을 활용해 코드 업로드전에 검증하도록 구성했어요

  3. 03 / 개선

    E2E 테스트 실행 시간 개선

    공통 초기화 작업을 묶고 테스트 실행을 직렬·병렬로 재설계했어요

    약 30% 개선 (37초 → 26초)

E2E 실행 구조를 재설계하여 테스트 시간을 개선

반복되는 초기화와 실행 의존 관계로 인해 길어진 테스트 시간을 직렬 · 병렬 실행 구조로 개선했어요

관련된 글이에요. [테스트 코드] 어떻게 하면 효율적인 E2E를 작성할 수 있을까?

  1. AS-IS / 병렬 실행 구조

    모션이 '추가', '수정', '삭제' 될 수 있다.

    - 모션 추가초기화 작업 → 모션 추가 → 검증 완료

    - 모션 수정초기화 작업 → 모션 추가 → 모션 수정 → 검증 완료

    - 모션 삭제초기화 작업 → 모션 추가 → 모션 삭제 → 검증 완료

    검증에 사용된 워커: 3개

  2. TO-BE / 직렬·병렬 실행 구조

    모션이 '추가', '수정', '삭제' 될 수 있다.

    초기화 작업 → 모션 추가 → 모션 수정 → 모션 삭제 → 검증 완료

    검증에 사용된 워커: 1개

    총 실행 시간 약 30% 개선 (37초 → 26초)

E2E 테스트를 통한 신규 단축키 기능의 버그 발견 및 핫픽스 기여

신규 단축키 기능의 E2E 시나리오를 작성하던 중 사내 디자인 에디터 코어 기능과의 조건부 충돌을 발견했어요

  1. STEP 01

    버그 발견

    특정 조건에서 '신규 단축키'와 '코어 기능의 단축키'가 충돌하는 것을 발견했어요

  2. STEP 02

    교차 검증

    팀원과 동일 조건에서 버그가 일어나는지 교차 검증을 진행했어요

  3. STEP 03

    이슈 공유

    재현 조건 · 원인 · 영향 범위를 정리하여 팀장님과 DRI에게 보고했어요

  4. STEP 04

    핫픽스 대응

    이슈가 제보되기 전에 인터랙션팀과 코어팀의 빠른 대응으로 문제를 해결했어요

그 외 주요 기여

  • 코드 제너레이터 패널 UX 개선

    사내 디자인 에디터에서 '레이어 선택'시, '최상위 레이어 코드'만 제공되어 작업 흐름이 자주 끊기는 문제가 있었어요

    '선택된 레이어 코드'와 '최상위 레이어 코드'를 함께 제공하도록 UI를 개선하여 불필요한 탐색 비용을 제거하고 개발자의 작업 흐름 단절을 줄였어요

  • Bezier · Spring 커스텀 Easing 패널 구현

    사내 디자인 에디터에서 정해진 토큰 값만 사용 가능한 제약이 있어 섬세한 인터랙션 구현에 제한이 있었어요

    트랜지션 easing 값을 직접 조정할 수 있도록 커스텀 패널을 구현하여 인터랙션 디자이너의 표현 자유도를 확장했어요

프로젝트

harryk-ds

UI 컴포넌트와 인터랙션 툴을 함께 제공하는 나만의 디자인 시스템

플랫폼 개발 경험을 확장하기 위해 시작한 개인 프로젝트예요. 모노레포 구조로 @harryk-ds/ui와 @harryk-ds/motion을 배포하고 있으며, AI와 협업하는 개발 환경도 함께 구축하고 있어요.

  • React
  • TypeScript
  • Vanilla Extract
  • Framer Motion
  • Vitest
  • Storybook
  • pnpm
  • GitHub Actions

OKLCH 기반 컬러 토큰 설계 및 자동화

OKLCH로 색상 계열 간 명도를 통일하고, SSOT 기반 구조로 컬러 토큰 생성을 자동화했어요

관련된 글이에요. [UI/UX] 디자인 시스템 컬러 토큰 다시 만들기

  1. 01 / 문제 상황

    같은 단계지만 서로 다른 색상의 밝기

    외부 팔레트 생성기로 만든 HEX 색상은 계열마다 같은 단계의 밝기가 달랐어요

    직접 수정도 시각적 판단에 의존해야 했기에, 색상의 일관성을 예측하고 관리할 수 있는 객관적인 기준이 필요했어요

  2. 02 / 색상 규칙 재설계

    HEX 코드 기반 컬러 토큰을 OKLCH로 변경

    OKLCH 색 영역에서 계열마다 명도(L)를 고정하고, sRGB 색역에 따라 채도(C)를 조정하는 방식으로 변경했어요

  3. 03 / 토큰 생성 자동화

    규칙에 따른 컬러 토큰 생성 자동화

    colors.source.ts에 색상 생성 규칙을 정의하고, 스크립트를 통해 코드용 컬러 토큰과 Figma용 JSON을 함께 생성했어요

  4. 04 / 얻은 결과

    변경에 유연한 컬러 토큰 설계

    Blue·Red·Grey 팔레트의 같은 단계 간 명암비 편차를 7% 이내로 줄일 수 있었어요

    또한 색상 팔레트를 추가해도 정의된 규칙에 따라 컬러 토큰이 자동 생성되도록 구성했어요

AI Native 개발 프로세스 구축

AI의 코드 생성 기준과 역할을 정의하고, 규칙이 확장되어도 일관되게 작업하도록 계층화했어요

관련된 글이에요. [AI] 일관성이 보장된 AI 개발 환경 구축하기

관련된 글이에요. [AI] 지속가능한 AI 개발 환경 구축하기

관련된 글이에요. [AI] 신뢰할 수 있는 AI 개발 환경 구축하기

  1. STEP 01

    역할 기반 AI 페르소나 작성

    작업 유형에 따라 필요한 AI의 역할을 정의했어요

    (페르소나: 개발 · 테스트 · 코드 리뷰 · 문서화 · 검증 · 회고)

  2. STEP 02

    페르소나 라우팅 자동화

    사용자의 요청 맥락에 따라 적절한 페르소나를 자동으로 선택하도록 router.md 를 작성했어요

  3. STEP 03

    작업별 스펙 모듈화

    스펙을 모듈화하여, 작업에 필요한 스펙만 조건부로 참조하도록 구성했어요

    (스펙: UI · Motion · Testing · Documentation)

  4. STEP 04

    4계층 단방향 AI 워크플로우 확립

    AGENTS.md → 라우터 → 페르소나 → 스펙

    규칙의 적용 방향을 계층화하여 불필요한 문서 참조를 줄이고, 문서 확장에도 대응할 수 있도록 설계했어요

그 외 주요 기여

  • 단위 테스트 작성을 통한 컴포넌트 동작 및 접근성 검증

    Storybook에서 정상 렌더링을 확인하는 것만으로는 API 계약과 상호작용, 접근성 문제를 발견하기 어려웠어요

    API 계약·엣지 케이스·접근성을 기준으로 테스트를 설계하고, 총 104개 테스트를 작성해 CI 검증에 적용했어요

  • AI 산출물 검증 게이트 도입

    AI가 생성한 코드가 개발 규칙을 따르더라도 실제 동작과 품질까지 보장하지는 못했어요

    AI가 생성된 코드를 생성한 뒤 완료를 선언하기 전에 lint·type-check·test·build의 4단계 검증을 수행하도록 구성했어요

다독다독

책에 대한 인사이트를 공유하고 소통하는 독서 소셜 플랫폼

"프로그래머스 데브코스"에서 시작된 팀 프로젝트로, 초기 개발 이후 프론트엔드 팀원들과 함께 서비스를 고도화했어요. UX 개선, 컴포넌트 시스템 구축, 아키텍처 개선 등 서비스의 완성도를 높였어요.

  • React
  • TypeScript
  • Next.js(app)
  • React-Query
  • TailwindCSS
  • Storybook

"도서 검색" 페이지에 검색 결과 유지 기능을 구현하여 UX 개선

"도서 검색" 페이지에서 다른 페이지로 이동 시 검색어와 검색 결과가 초기화 되는 문제를 해결했어요

관련된 작업이에요. [#592] [도서 검색] 검색 키워드 및 결과 유지 기능 구현

  1. AS-IS / 페이지 이동시 검색 상태 초기화

    다시 검색해야하는 사용자의 불편함

    도서를 검색한 뒤 상세 페이지를 방문하고 돌아오면 검색어와 검색 결과가 초기화되어 다시 검색해야 했어요

  2. TO-BE / URL 기반 검색 상태 관리

    검색 키워드를 URL 쿼리 파라미터와 동기화

    검색 키워드를 URL 쿼리 파라미터와 동기화하고, useQueryParams 훅으로 관련 로직을 추상화했어요

    그 결과 뒤로가기와 새로고침 이후에도 검색 상태를 유지하고, 검색 결과를 URL로 공유할 수 있게 됐어요

"독서모임 생성" 페이지에 Funnel을 도입하여 UX 개선

한 곳에 모여있던 입력 항목들에 Funnel을 도입하여 입력 과정을 단계화하고, 사용자의 시각적 부담을 줄였어요

관련된 작업이에요. [#581] [모임 생성] 모임 생성 퍼널 페이지 작성

관련된 글이에요. [React] 많이 늦은 toss의 useFunnel 적용기

  1. AS-IS / 하나의 화면에 집중된 입력 항목

    흐려지는 사용자의 집중력

    독서모임 생성에 필요한 여러 입력 항목이 한 화면에 모여 있어, 사용자가 느끼는 입력 부담이 크다고 판단했어요

    사용자가 느끼는 불편은 페이지 이탈률 상승으로 이어진다고 판단했어요

  2. TO-BE / 4단계 입력 흐름으로 분리

    useFunnel 작성 및 Funnel 적용

    도서 선택 → 모임 이름 → 모임 정보 → 가입 유형

    @toss/use-funnel을 Next.js App Router 환경에 맞게 수정하여 단계별 입력 흐름을 구현했어요

    퍼널은 단계 전환만 담당하도록 조정하고, 폼 상태는 react-hook-form에 맡겨 책임을 분리했어요

자체 이미지 최적화 파이프라인 구축

Sharp · API Routes를 활용한 자체 이미지 최적화를 통해, Vercel의 next/image 캐싱 한도 제약을 극복했어요

관련된 작업이에요. [#654] 자체 이미지 최적화 작업

관련된 글이에요. [이미지 최적화] 02. Next/Image의 한계점, 그에 대한 대책

  1. STEP 01

    문제 상황

    Vercel의 월간 next/image 최적화 호출 한도에 도달하여 이미지가 로드되지 않는 치명적 이슈가 발생했어요

  2. STEP 02

    해결 과정

    Sharp와 API Routes를 활용해 WebP 이미지 확장자 변환 최적화를 구현했어요

    next/image의 Props를 상속한 Image 컴포넌트를 작성하여, 코드 변경 범위를 최소화했어요

  3. STEP 03

    얻은 결과

    Vercel의 이미지 최적화 호출 한도에서 벗어났어요

    최적화 정책이 한곳에 모여, 향후 다른 방식으로 전환하기 쉬운 구조가 됐어요

그 외 주요 기여

  • 재사용 가능한 컴포넌트 시스템 구축

    초기 개발 단계에서 팀원들이 각자 페이지를 구현하며 동일한 역할의 UI가 서로 다른 스타일과 구조로 작성됐던 문제가 있었어요

    페이지마다 중복 구현했던 UI를 공용 컴포넌트로 통합하고, 팀원들과 함께 일관된 컴포넌트를 재사용할 수 있는 기반을 마련했어요

    관련된 작업이에요. Figma 링크

  • 점진적 App Router 마이그레이션 및 초기 JS 번들 개선

    팀의 기술적 도전인 App Router 마이그레이션, 프로젝트 리디자인 및 ChakraUI → TailwindCSS 전환을 함께 진행했어요

    결과적으로 First Load JS를 223kB → 80.1kB으로 약 64% 개선했어요

    관련된 글이에요. [Next.js] 서버 컴포넌트에 대한 오해 (2)

  • PWA 적용 및 iOS 모바일 웹 대응

    Web App Manifest와 Service Worker를 구성해 홈 화면에 설치할 수 있는 웹앱 경험을 제공했어요

    iOS에서는 Safe Area, DatePicker 컴포넌트 등 모바일 환경에서 발생하는 UI 문제에 개별 대응했어요

    관련된 작업이에요. [#578] iOS 환경에서의 DatePicker UI 수정

다독다독 (beta)

책에 대한 인사이트를 공유하고 소통하는 독서 소셜 플랫폼

"프로그래머스 데브코스"에서 진행한 팀 프로젝트예요. 사용자 직군에 따른 인기도서 추천, 인기책장 큐레이팅, 북 코멘트, 독서 모임 기능을 제공해요.

  • React
  • TypeScript
  • Next.js(page)
  • React-Query
  • Chakra UI

서버 프록시를 통한 CORS 문제 해결

책 표지 이미지의 지배적인 색상을 추출하는 과정에서 발생한 CORS 이슈를 API Routes를 활용하여 해결했어요

  1. STEP 01

    문제 상황

    외부 출처의 이미지가 Canvas에 그려지면 픽셀 데이터 읽기가 제한되는 Canvas Tainting 문제를 확인했어요

  2. STEP 02

    해결 과정

    브라우저에서 수행하던 색상 추출 로직을 Next.js API Routes로 이전했어요

  3. STEP 03

    얻은 결과

    서버에서 이미지를 가져와 대표 색상을 추출하고, 클라이언트에는 색상값만 전달하도록 변경했어요

그 외 주요 기여

  • "유저 책장" 페이지에 무한 스크롤 구현

    유저 책장 페이지에 모든 데이터를 한 번에 불러오는 방식은 초기 로딩 비용이 커지고, 목록을 탐색하는 경험도 불편해질 수 있었어요

    무한 스크롤을 구현하여 필요한 데이터만 단계적으로 가져오고, 연속적으로 책장을 탐색할 수 있는 UI를 제공했어요

    관련된 작업이에요. [#103] 책장 페이지 > 무한 스크롤 기능 추가

  • "책장 좋아요" 버튼에 낙관적 UI 업데이트 적용

    책장 좋아요 버튼을 클릭해도 서버 응답이 완료된 후에야 UI가 변경되어 즉각적인 반응을 확인하기 어려웠어요

    낙관적 UI 업데이트를 적용하여 서버 응답 이전에 좋아요 상태와 개수를 갱신했어요, 요청 실패 시 이전 상태로 롤백하고, 요청 종료 후 서버 데이터를 다시 검증해요

    관련된 작업이에요. [#457] LikeButton 컴포넌트

학력 및 활동

디프만 - Depromeet

  • 디자이너와 개발자가 서비스 기획부터 런칭까지 함께 경험하는 성장추구형 커뮤니티

    19기 Web 파트 활동중 (26.10 - )

프로그래머스 데브코스

  • 프론트엔드 교육과정

    교육과정 수료 (22.10 - 23.03)

원광대학교

  • 컴퓨터소프트웨어공학과

    전과 및 졸업(학사) (20.03 - 23.02)

  • 수학교육과

    이전학과 (17.03 - 18.02)