Next.js 기반 개인 기술 블로그입니다.

글 작성 저장소와 블로그 앱 저장소를 분리해 운영합니다.

이 저장소는 yunkoo.dev를 구성하는 Next.js 블로그 앱입니다.
블로그 화면, 라우팅, MDX 렌더링, SEO 메타데이터, 배포 파이프라인을 담당합니다.

글 원본은 별도 private 저장소에서 관리하고, 이 저장소는 배포할 글 커밋을 submodule pointer로 고정합니다.
덕분에 글을 자유롭게 작성하되, 공개 시점은 blog 저장소에서 명시적으로 제어할 수 있습니다.

flowchart TD
 posts["blog-posts<br/>글 저장소"]
 blog["blog<br/>submodule pointer 갱신"]
 actions["GitHub Actions"]
 vercel["Vercel 배포"]
 site["yunkoo.dev"]
 posts --> blog
 blog --> actions
 actions --> vercel
 vercel --> site
 posts -. "push만으로는 공개 안 됨" .-> blog

글은 blog-posts에서 작성하지만, 실제 배포는 blog 저장소의 submodule pointer가 갱신될 때만 실행됩니다.

1. blog-posts에서 글을 자유롭게 작성하고 수정한 뒤 최종안을 올립니다.
2. 게시할 시점에 blog 저장소의 content-source/posts submodule pointer를 최종 글 커밋으로 갱신합니다.
3. blog 저장소의 main에 변경이 반영되면 GitHub Actions가 실행됩니다.
4. Actions는 blog 저장소에 기록된 글 커밋을 가져온 뒤 Vercel CLI로 production 배포를 수행합니다.

로컬 실행, secrets 설정, 글 게시 절차는 GitHub Wiki에 정리했습니다.

MDX 글 작성에 사용하는 컴포넌트와 예시는 yunkoo.dev/design에서 확인할 수 있습니다.

src/app
 ├─ (site) # 블로그 공개 라우트
 ├─ (site)/design # MDX 디자인 가이드
 ├─ robots.ts # robots.txt
 └─ sitemap.ts # sitemap.xml
src/features/posts
 ├─ data # 글 데이터 조회, frontmatter 파싱, 타입
 ├─ components # MDX 본문 렌더링
 └─ utils # post 관련 유틸
src/features/design # 디자인 가이드 데이터와 사이드바
src/components/mdx # 글 꾸미기용 MDX 컴포넌트
src/components # 공통 UI
content-source/posts # private posts repo submodule

• 글을 SSG로 빠르게 제공하고 SEO를 안정적으로 관리
• 추후 댓글·좋아요 같은 부가 기능은 ISR로 확장할 수 있게 설계
• 글 작성과 앱 개발을 분리해 초안 작업을 자유롭게 하고, 명시적으로 반영한 글만 배포되도록 구성