Next.js 패턴
App Router
app/ 디렉토리에 위치한 Next.js 15 App Router를 사용합니다.
페이지
- 위치:
app/[route]/page.tsx - 컴포넌트: 기본 내보내기(default export) 함수입니다.
- 클라이언트 vs 서버: 상태(
useState,useEffect)나 브라우저 API가 필요한 컴포넌트는 최상단에"use client"지시어를 사용합니다. 그 외에는 서버 컴포넌트를 기본으로 사용합니다.
레이아웃
- 위치:
app/layout.tsx(루트),app/[route]/layout.tsx(중첩) - 목적: 페이지를 감싸는 래퍼(wrapper)로, 내비게이션, 폰트, 메타데이터를 보관합니다.
내비게이션
- 내부 내비게이션에는
next/link의Link를 사용합니다. - 프로그래매틱 내비게이션(클라이언트 컴포넌트 내부)에는
next/navigation의useRouter를 사용합니다.
import Link from "next/link";
import { useRouter } from "next/navigation";
// Link
<Link href="/dashboard">Dashboard</Link>
// Router
const router = useRouter();
router.push('/login');
데이터 페칭
- 서버 컴포넌트:
await fetch()또는 데이터베이스 호출을 사용하여 직접 가져옵니다. - 클라이언트 컴포넌트:
useEffect또는 SWR/TanStack Query(추후 추가 예정)를 사용합니다. 현재는useEffect내에서 표준fetch를 사용합니다.
폰트 최적화
app/layout.tsx에서next/font/google(예: Poppins)을 사용합니다.- 가변 폰트(variable fonts)는
bodyclassName에 전달됩니다.
메타데이터
- SEO를 위해
page.tsx또는layout.tsx에export const metadata: Metadata = { ... }를 정의합니다.