nextjs-16
Next.js 16 App Router patterns. Trigger: When working with Next.js - routing, Server Actions, data fetching.
- License 许可
- Apache-2.0
- 最近更新
- 2026-08-26
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- nextjs-16
- license
- Apache-2.0
- metadata
- { "author": "gentleman-programming", "version": "2.0" }
- description
- Next.js 16 App Router patterns. Trigger: When working with Next.js - routing, Server Actions, data fetching.
02 资源文件 13
- 参考文档.skill-meta.json417 B
- 资产文件assets/01-example.tsx25 B
- 脚本assets/01-server-action.ts296 B
- 资产文件assets/nextjs-16-complete-example.tsx4.1 KB
- 参考文档README.md2.6 KB
- 参考文档references/01-app-router.md265 B
- 参考文档references/01-guide.md38 B
- 参考文档references/02-patterns.md29 B
- 参考文档references/02-server-actions.md262 B
- 参考文档references/03-data-fetching.md284 B
- 参考文档references/app-router-fundamentals.md2.4 KB
- 参考文档references/caching-data-fetching.md2.6 KB
- 参考文档references/server-actions.md2.7 KB
03 SKILL.md 正文
App Router File Conventions
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)
Server Components (Default)
// No directive needed - async by default
export default async function Page() {
const data = await db.query();
return <Component data={data} />;
}
Params & SearchParams (Next.js 15 - Promise)
// params is now a Promise
export default async function ProductPage({ params }: { params: Promise<{ id: string }> }) {
const { id } = await params;
const product = await getProduct(id);
return <Product product={product} />;
}
// searchParams is also a Promise
export default async function Page({ searchParams }: { searchParams: Promise<Record<string, string>> }) {
const { q } = await searchParams;
const results = await search(q);
return <Results results={results} />;
}
Server Actions
// 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>
Data Fetching
// 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>
Caching (Next.js 15)
// Static by default - cached until invalidation
export const revalidate = 3600; // seconds
// Dynamic
export const dynamic = "force-dynamic";
// No cache
export const fetchCache = "force-no-store";
// Tag-based revalidation
export async function getData() {
"use cache";
return db.query();
}
export async function revalidateData() {
revalidateTag("users");
}
Partial Prerendering
// app/page.tsx
import { Suspense } from "react";
export default function Page() {
return (
<>
<header>Cached Header</header>
<Suspense fallback={<Skeleton />}>
<DynamicContent />
</Suspense>
</>
);
}
Route Handlers (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
// 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*"],
};
Metadata
// Static
export const metadata = {
title: "My App",
description: "Description",
};
// Dynamic
export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params;
const product = await getProduct(slug);
return { title: product.name };
}
server-only Package
import "server-only";
// This will error if imported in client component
export async function getSecretData() {
return db.secrets.findMany();
}
Cookies (Next.js 15)
import { cookies } from "next/headers";
export async function getSession() {
const cookieStore = await cookies();
return cookieStore.get("session")?.value;
}
Resources
See references/ for detailed guides:
references/app-router-fundamentals.md- File conventions, Server Components, route groupsreferences/server-actions.md- Server Actions patterns, forms, error handlingreferences/caching-data-fetching.md- Caching strategies, data fetching, Suspense, PPR
Code examples in assets/:
assets/nextjs-16-complete-example.tsx- Complete working example with layouts, pages, API routes, Server Actions, middleware
External Resources
- Main Docs: https://nextjs.org/docs
- App Router: https://nextjs.org/docs/app
- Server Actions: https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions
- Server Components: https://nextjs.org/docs/app/building-your-application/rendering/server-components
04 同仓库更多 Skills
zustand-5
Zustand 5 state management patterns. Trigger: When managing React state with Zustand.
zod-4
Zod 4 schema validation patterns. Trigger: When using Zod for validation - breaking changes from v3.
x-bookmark-quote-posts
Workflow para revisar bookmarks de X/Twitter y convertirlos en drafts de quote posts. Accede a la sección de bookmarks vía browser headless, extrae posts recientes, y genera drafts con voz personal del usuario. No publica ni muta X — solo genera contenido para revisión. Trigger: X bookmarks, Twitter bookmarks, quote posts, bookmark automation, crear quote posts, revisar bookmarks, growth content X.
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
work-unit-commits
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.