CLAUDE.md — Next.js Blog

Overview

MDX 기반 기술 블로그. App Router + TailwindCSS 사용.

Commands

npm run dev          # 개발 서버 (localhost:3000)
npm run build        # 프로덕션 빌드
npm run new-post     # 새 블로그 포스트 생성 스크립트

Conventions

• 파일명: kebab-case (my-first-post.mdx)
• 컴포넌트: PascalCase
• MDX 파일 위치: content/posts/
• 이미지: public/images/posts/{slug}/
• 날짜 형식: YYYY-MM-DD (frontmatter)

Architecture

app/
  (blog)/
    page.tsx          # 블로그 목록 (페이지네이션)
    [slug]/page.tsx   # 포스트 상세
  layout.tsx
content/
  posts/              # MDX 파일
components/
  blog/               # 블로그 전용 컴포넌트
  mdx/                # MDX 커스텀 컴포넌트

SEO

• 각 포스트에 title, description, og:image 메타 필수
• generateMetadata()로 동적 메타 생성
• sitemap.ts로 자동 사이트맵 생성
• RSS 피드: /feed.xml 자동 생성

Content Rules

• frontmatter 필수 필드: title, date, description, tags
• 코드 블록에는 반드시 언어 명시
• 이미지는 next/image 사용 (width, height 필수)
• 외부 링크는 target="_blank" rel="noopener"