mcpField
N
nextjs-15

nextjs-15

github.com/gentleman-programming開発661181 回インストール31 週間前に更新
リポジトリ

nextjs-15 について

nextjs-15は、Next.js 15アプリを開発する人向けに、App Routerの規約と一般的な実装パターンをまとめたスキルです。サーバーコンポーネント、Server Actions、データ取得、ルートハンドラー、ミドルウェア、メタデータを扱います。

主な機能

  1. 01App Routerのファイル規約
  2. 02サーバーコンポーネントとServer Actions
  3. 03並列データ取得の例
  4. 04APIルートハンドラーの解説
  5. 05ミドルウェアとページメタデータの設定

活用シーン

  1. 01App Routerのページとレイアウト設計
  2. 02サーバー側フォーム操作の実装
  3. 03ページデータの並列取得
  4. 04APIルートとアクセス制御ミドルウェアの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gentleman-programming/gentleman-skills --skill nextjs-15

インストール後、Claude Code で/nextjs-15を入力して読み込まれたか確認します。

詳細

App Router のファイル規約

app/
├── layout.tsx          # Root layout (required)
├── page.tsx            # Home page (/)
├── loading.tsx         # Loading UI (Suspense)
├── error.tsx           # Error boundary
├── not-found.tsx       # 404 page
├── (auth)/             # Route group (no URL impact)
│   ├── login/page.tsx  # /login
│   └── signup/page.tsx # /signup
├── api/
│   └── route.ts        # API handler
└── _components/        # Private folder (not routed)

サーバーコンポーネント（デフォルト）

// No directive needed - async by default
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");
}

// Usage
<form action={createUser}>
  <input name="name" required />
  <button type="submit">Create</button>
</form>

データ取得

// Parallel
async function Page() {
  const [users, posts] = await Promise.all([
    getUsers(),
    getPosts(),
  ]);
  return <Dashboard users={users} posts={posts} />;
}

// Streaming with 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 (root level)
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*"],
};

メタデータ

// Static
export const metadata = {
  title: "My App",
  description: "Description",
};

// Dynamic
export async function generateMetadata({ params }) {
  const product = await getProduct(params.id);
  return { title: product.name };
}

server-only パッケージ

import "server-only";

// This will error if imported in client component
export async function getSecretData() {
  return db.secrets.findMany();
}

キーワード

nextjs, next.js, app router, server components, server actions, streaming

コメント

Markdown 対応