컨텐츠 영역 바로가기

Clein's Portfolio

구 형태 3D 메쉬 오브젝트곱하기 기호 형태 3D 메쉬 오브젝트

Clein's Portfolio 프로젝트 아이콘Clein's Portfolio

이름Clein's Portfolio
설명Next.js 기반 개인 포트폴리오 사이트
유형개인 프로젝트
기간2024.12 ~ 운영 중
도메인https://clein-dev.com
GitHubhttps://github.com/LC-02s/Project-Clein
사용 기술

Next.js React TypeScript Zustand Tanstack Query TailWindCSS Motion MDX pnpm

관련 포스트


목차

  1. 프로젝트 소개
  2. 사용 기술
  3. 트러블 슈팅


프로젝트 소개


소개 랜딩페이지, 이력서, 블로그, 참여했던 프로젝트 모음 등의 내용으로 구성된 Next.js 기반 개인 포트폴리오 사이트 프로젝트입니다. 디자이너 시절부터 가지고 싶었던 제 작업물들을 모아두는 사이트와 함께 블로그 및 이력서를 포함하는 저의 모든 포트폴리오들을 한 곳에 정리해두고 편하게 보여주기 위해 만들게 되었습니다.



사용 기술

사이트에 사용된 기술과 이유입니다.


Next.js

  • 컨텐츠를 보여주는 것에 특화된 사이트를 구축함에 있어 사용자 경험을 고려하여 SSR 방식을 선택했고, 이를 쉽게 구현하기 위해 도입하였습니다.
  • 프로젝트 초기 부터 리소스 관리를 통한 운영 비용 절감을 고려하였기에, 만약 백엔드 로직이 필요한 경우가 생기더라도 내부에서 Route Handler를 통해 처리하여 서버 1개만으로 모든 것을 관리할 수 있는 점도 매력적이었습니다.

TypeScript

  • 예상하지 못한 런타임 에러를 미연에 방지하여 사이트의 안정성을 보장하기 위해 도입하였습니다.
  • Next.js와 연계하여 API에 대한 요청 및 응답 스키마를 통합하여 관리할 수 있었습니다.

Zustand

  • overlay 요소나 반응형 breakpoint, 다크 모드 같이 사이트를 구성하는 UI를 만드는데 필요한 최소한의 전역 상태관리에 사용하기 위해 도입하였습니다.
  • 개인적으로 Redux는 보일러플레이트 코드가 아쉽고, Context API는 최적화하기 번거로워 전역 상태관리에는 부적합하다고 생각합니다.

Tanstack Query

  • Next.js의 서버 컴포넌트와 fetch 조합만으로 구현하기에는 아쉬운 클라이언트에서 실행되는 UI 로직 내부에서의 서버 상태관리를 위해 도입하게 되었습니다.

TailWindCSS

  • 스타일을 작성함에 있어 클래스 또는 변수 작명에 신경을 쓰지 않아도 된다는 점과, 마크업과 스타일을 이동하는 컨텍스트 스위칭을 없앨 수 있다는 점이 마음에 들어 도입하게 되었습니다.
  • tailwind-mergeclass-variance-authority 등의 라이브러리를 함께 조합하여 컴포넌트 재사용성과 타입 안정성을 높일 수 있었습니다.

Motion

  • 특별한 처리 없이도 컴포넌트 라이프 사이클에 맞춰 손쉽게 애니메이션을 구현할 수 있는 DX를 제공한다는 점이 매력적이었습니다.
  • 일반적인 UI에 더불어 Scroll Parallax UI를 구현하는 데에도 사용할 수 있었습니다.

MDX

  • mdx 언어를 사용하지는 않았지만 마크다운 문서를 편하게 파싱하기 위한 용도로 사용하기 위해 next-mdx-remote 패키지를 도입하였습니다.
  • 마크다운 문서에 HTML 문법을 사용할 시 올바르게 파싱되지 않는 문제가 있어 정규 표현식을 활용한 전처리 로직을 추가하였습니다.

pnpm

  • 배포 파이프라인에서의 빌드 속도와 로컬 환경에서의 패키지 용량 관리를 위해 도입하였습니다.


트러블 슈팅


Scroll Parallax UI 프레임 드랍 이슈



Route Handler 배포 환경 관련 이슈



Next.js 기반 동적 이미지 생성 기능 관련 이슈