Next.js App Router로 정적 블로그 만들기

왜 SSG인가

검색 엔진과 CDN에 친화적인 HTML을 배포할 수 있고, 방문자에게 빠른 첫 화면을 제공할 수 있습니다. 데이터베이스 없이 파일 기반으로 운영하면 백업과 버전 관리도 단순해집니다.

이 블로그는 content/posts 아래 마크다운을 읽어 빌드 타임에 페이지를 만듭니다.

빌드 파이프라인 요약

1. 글을 마크다운으로 작성하고 frontmatter를 채웁니다.
2. next build 시 모든 글 목록과 상세 경로가 생성됩니다.
3. 배포 후에는 정적 파일만 제공하면 됩니다.

App Router에서의 주의점

동적 세그먼트는 generateStaticParams로 미리 경로를 알려 주어야 완전한 정적 출력에 유리합니다. 클라이언트 전용 기능은 작은 단위로 나누어 'use client' 경계를 두는 편이 좋습니다.

캐싱과 재검증

블로그 글만 다룬다면 대부분 빌드 시점의 스냅샷으로 충분합니다. 뉴스처럼 자주 바뀌는 데이터가 아니라면 ISR까지 갈 필요가 없을 수 있습니다.

마무리

파일 하나가 곧 한 포스트가 되는 구조는 콘텐츠 제작에 집중하기 좋습니다. 템플릿을 자신의 브랜드에 맞게 다듬어 보세요.