recodelog.com — 개발 블로그

02기술 결정

문제가 무엇이었고, 무엇을 골랐고, 그래서 어떻게 됐는지.

1. 결정 01

   유지보수가 멈춘 라이브러리는 쓰지 않는다

   문제

   ContentLayer가 사실상 표준처럼 쓰이고 있었지만, 착수 시점에 저장소 활동이 멈춰 있었습니다. 지금 동작한다는 것과 1년 뒤에도 동작한다는 것은 다른 이야기입니다.

   선택

   대안을 찾아 Velite를 검토하고 도입했습니다. 자료가 적다는 단점이 있었지만 공식 문서가 충분했고, 관리가 이어지고 있다는 점을 더 중요하게 봤습니다.

   결과

   이후 Next.js 버전을 올릴 때 콘텐츠 파이프라인 때문에 막힌 적이 없습니다. 라이브러리를 고를 때 '기능'보다 '관리 상태'를 먼저 보는 기준이 이때 생겼습니다.

2. 결정 02

   글은 파일로 관리한다

   문제

   블로그에 관리자 화면과 데이터베이스를 붙이면 그 자체가 유지보수 대상이 됩니다. 글 하나 쓰려고 로그인하고 에디터를 띄우는 것도 마찰입니다.

   선택

   MDX 파일을 저장소에 커밋하는 방식으로 갔습니다. 글은 코드와 같은 흐름으로 리뷰되고 배포됩니다.

   결과

   인프라가 줄었고 백업이 곧 git 히스토리가 됐습니다. 글을 쓰는 것과 코드를 고치는 것이 같은 도구 안에서 끝납니다.

3. 결정 03

   디자인 시스템을 먼저 정하고 글을 쓴다

   문제

   블로그는 글이 쌓일수록 형태가 흐트러집니다. 매번 스타일을 조금씩 다르게 하면 나중에 통일할 수 없습니다.

   선택

   shadcn/ui와 Tailwind로 컴포넌트 기본값을 먼저 정하고, 본문 타이포그래피 스케일을 고정한 뒤 글을 쓰기 시작했습니다.

   결과

   글이 늘어도 형태가 유지됩니다. 새 글을 쓸 때 스타일을 고민하지 않아도 되는 것이 실제로 가장 큰 이득이었습니다.

03주요 기능

• MDX 기반 글 작성

  Velite로 MDX를 타입이 있는 데이터로 변환해 사용합니다.

• 태그·카테고리 탐색

  주제별로 글을 좁혀 볼 수 있는 탐색 구조.

• 다크·라이트 모드

  코드 블록 테마까지 함께 전환됩니다.

• SEO와 OG

  글마다 메타데이터와 OG 이미지를 생성해 공유 시 형태를 유지합니다.

04화면

05회고