feat: 블로그를 Vercel 정적 중심 구조로 전환하고 메타데이터/탐색 로직 정리

[sunub]

변경 배경

기존 블로그는 EC2/Nest 런타임을 전제로 동작하고 있었지만, 실제 서비스 성격은 파일 기반 콘텐츠를 빌드 시 생성해 제공하는 구조에 더 적합했습니다.
이번 PR에서는 블로그를 Vercel에 배포되는 정적 중심 Next.js 앱으로 전환하면서, 기존 기능을 최대한 유지한 채 런타임 의존성과 배포 리스크를 줄이는 방향으로 구조를 정리했습니다.

주요 변경 사항

• 빌드 시 posts.jsonl, post-index.json, search-index.json를 생성하는 정적 콘텐츠 파이프라인을 추가했습니다.
• 홈, 아카이브, 최신글, 검색이 더 이상 backend API에 의존하지 않고 정적 산출물을 사용하도록 변경했습니다.
• 포스트 상세 페이지는 기존 MDX 기반 렌더링을 유지하면서 generateStaticParams() 기반 SSG 경로로 고정했습니다.
• 요청 기반 테마 판별을 제거하고, 첫 페인트 전에 적용되는 초기 테마 스크립트 기반으로 전환했습니다.
• 테마 전환 과정에서 발생하던 hydration mismatch를 해결하기 위해 토글 아이콘과 히어로 이미지 렌더링 방식을 정리했습니다.
• 아카이브 영역의 초기 underfill 상황에서도 정상적으로 추가 로드가 동작하도록 자동 로드 게이트 로직을 보완했습니다.
• robots.txt, manifest.webmanifest, sitemap.xml이 정적으로 생성되도록 메타데이터 라우트를 정리했습니다.
• 사이트 URL을 중앙에서 관리할 수 있도록 packages/contracts에 resolver를 추가하고, layout/metadata/sitemap/robots/canonical/OG URL 하드코딩을 제거했습니다.
• 공개 정적 JSON에서 절대 파일 경로가 노출되지 않도록 데이터 계약을 분리하고, 서버 전용 인덱스와 public 인덱스의 역할을 구분했습니다.
• typescript.ignoreBuildErrors를 제거해 실제 타입 오류가 빌드 단계에서 드러나도록 수정했습니다.
• EC2/Nest 런타임 전제를 두던 rewrite 및 배포 관련 설정을 정리하고, lint/biome 기준에 맞게 포맷과 import 순서를 정리했습니다.

세부 작업

• 정적 블로그 데이터 생성 스크립트 추가
• 정적 인덱스 로더 및 검색 인덱스 로직 추가
• archive/latest/search 데이터 소스 교체
• theme 초기화 및 hydration 안정화
• hero preload 전략 수정
• archive load-more 동작 보완
• metadata/robots/manifest/sitemap 정리
• URL 중앙 관리 유틸 추가
• public 데이터에서 filePath 제거
• lint/biome 오류 수정 및 포맷 정리

검증

• pnpm --filter frontend run build
• pnpm --filter frontend exec tsc --noEmit
• pnpm lint
• pnpm exec biome ci

기대 효과

• 블로그 메인 배포 경로에서 backend 런타임 의존성 제거
• Vercel 배포에 적합한 정적 중심 구조 확보
• 테마 및 hydration 안정성 개선
• 공개 데이터 보안성 및 메타데이터 관리성 향상
• 유지보수성과 배포 신뢰도 개선

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
sunub-github-io	Ready	Preview, Comment	Mar 24, 2026 8:12am