App Router 파일 컨벤션
app/
├── layout.tsx # 루트 레이아웃 (필수)
├── page.tsx # 홈 페이지 (/)
├── loading.tsx # 로딩 UI (Suspense)
├── error.tsx # 에러 경계
├── not-found.tsx # 404 페이지
├── (auth)/ # 라우트 그룹 (URL 영향 없음)
│ ├── login/page.tsx # /login
│ └── signup/page.tsx # /signup
├── api/
│ └── route.ts # API 핸들러
└── _components/ # 비공개 폴더 (라우팅되지 않음)
서버 컴포넌트 (기본)
// 지시어 불필요 - 기본적으로 async
export default async function Page() {
const data = await db.query();
return <Component data={data} />;
}
서버 액션
// app/actions.ts
"use server";
import { revalidatePath } from "next/cache";
import { redirect } from "next/navigation";
export async function createUser(formData: FormData) {
const name = formData.get("name") as string;
await db.users.create({ data: { name } });
revalidatePath("/users");
redirect("/users");
}
// 사용 예
<form action={createUser}>
<input name="name" required />
<button type="submit">생성</button>
</form>
데이터 페칭
// 병렬
async function Page() {
const [users, posts] = await Promise.all([
getUsers(),
getPosts(),
]);
return <Dashboard users={users} posts={posts} />;
}
// Suspense로 스트리밍
<Suspense fallback={<Loading />}>
<SlowComponent />
</Suspense>
라우트 핸들러 (API)
// app/api/users/route.ts
import { NextRequest, NextResponse } from "next/server";
export async function GET(request: NextRequest) {
const users = await db.users.findMany();
return NextResponse.json(users);
}
export async function POST(request: NextRequest) {
const body = await request.json();
const user = await db.users.create({ data: body });
return NextResponse.json(user, { status: 201 });
}
미들웨어
// middleware.ts (루트 레벨)
import { NextResponse } from "next/server";
import type { NextRequest } from "next/server";
export function middleware(request: NextRequest) {
const token = request.cookies.get("token");
if (!token && request.nextUrl.pathname.startsWith("/dashboard")) {
return NextResponse.redirect(new URL("/login", request.url));
}
return NextResponse.next();
}
export const config = {
matcher: ["/dashboard/:path*"],
};
메타데이터
// 정적
export const metadata = {
title: "내 앱",
description: "설명",
};
// 동적
export async function generateMetadata({ params }) {
const product = await getProduct(params.id);
return { title: product.name };
}
server-only 패키지
import "server-only";
// 클라이언트 컴포넌트에서 임포트하면 에러 발생
export async function getSecretData() {
return db.secrets.findMany();
}
키워드
nextjs, next.js, app router, server components, server actions, streaming