[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6HR8YYJNG5KB4V78NQDG02V":3,"skill-same:01M6HR8YYJNG5KB4V78NQDG02V":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":56,"install":57,"resources":70},"01M6HR8YYJNG5KB4V78NQDG02V","nextjs-app-router-patterns",null,"Master Next.js 14+ App Router with Server Components, streaming, parallel routes, and advanced data fetching. Use when building Next.js applications, implementing SSR\u002FSSG, or optimizing React Server Components.","welflau\u002Fai-dev-system","welflau","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7010385?v=4","01M6HPTDGF18RFY07M229P8CTM","01M6HPTDMRMZCJPYBFEA9XVVYT",3,"MIT","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ffrontend-mobile-development\u002Fskills\u002Fnextjs-app-router-patterns\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"app router","nextjs","nextjs app router patterns","nextjs app router","router","app","patterns","master","when","data fetching","implementing","Server Components","advanced","next","components","parallel","applications","data","server","streaming","ssr","react","2026-11-10 10:12:30",false,"---\nname: nextjs-app-router-patterns\ndescription: Master Next.js 14+ App Router with Server Components, streaming, parallel routes, and advanced data fetching. Use when building Next.js applications, implementing SSR\u002FSSG, or optimizing React Server Components.\n---\n\n# Next.js App Router Patterns\n\nComprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.\n\n## When to Use This Skill\n\n- Building new Next.js applications with App Router\n- Migrating from Pages Router to App Router\n- Implementing Server Components and streaming\n- Setting up parallel and intercepting routes\n- Optimizing data fetching and caching\n- Building full-stack features with Server Actions\n\n## Core Concepts\n\n### 1. Rendering Modes\n\n| Mode | Where | When to Use |\n|------|-------|-------------|\n| **Server Components** | Server only | Data fetching, heavy computation, secrets |\n| **Client Components** | Browser | Interactivity, hooks, browser APIs |\n| **Static** | Build time | Content that rarely changes |\n| **Dynamic** | Request time | Personalized or real-time data |\n| **Streaming** | Progressive | Large pages, slow data sources |\n\n### 2. File Conventions\n\n```\napp\u002F\n├── layout.tsx       # Shared UI wrapper\n├── page.tsx         # Route UI\n├── loading.tsx      # Loading UI (Suspense)\n├── error.tsx        # Error boundary\n├── not-found.tsx    # 404 UI\n├── route.ts         # API endpoint\n├── template.tsx     # Re-mounted layout\n├── default.tsx      # Parallel route fallback\n└── opengraph-image.tsx  # OG image generation\n```\n\n## Quick Start\n\n```typescript\n\u002F\u002F app\u002Flayout.tsx\nimport { Inter } from 'next\u002Ffont\u002Fgoogle'\nimport { Providers } from '.\u002Fproviders'\n\nconst inter = Inter({ subsets: ['latin'] })\n\nexport const metadata = {\n  title: { default: 'My App', template: '%s | My App' },\n  description: 'Built with Next.js App Router',\n}\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode\n}) {\n  return (\n    \u003Chtml lang=\"en\" suppressHydrationWarning>\n      \u003Cbody className={inter.className}>\n        \u003CProviders>{children}\u003C\u002FProviders>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n\n\u002F\u002F app\u002Fpage.tsx - Server Component by default\nasync function getProducts() {\n  const res = await fetch('https:\u002F\u002Fapi.example.com\u002Fproducts', {\n    next: { revalidate: 3600 }, \u002F\u002F ISR: revalidate every hour\n  })\n  return res.json()\n}\n\nexport default async function HomePage() {\n  const products = await getProducts()\n\n  return (\n    \u003Cmain>\n      \u003Ch1>Products\u003C\u002Fh1>\n      \u003CProductGrid products={products} \u002F>\n    \u003C\u002Fmain>\n  )\n}\n```\n\n## Patterns\n\n### Pattern 1: Server Components with Data Fetching\n\n```typescript\n\u002F\u002F app\u002Fproducts\u002Fpage.tsx\nimport { Suspense } from 'react'\nimport { ProductList, ProductListSkeleton } from '@\u002Fcomponents\u002Fproducts'\nimport { FilterSidebar } from '@\u002Fcomponents\u002Ffilters'\n\ninterface SearchParams {\n  category?: string\n  sort?: 'price' | 'name' | 'date'\n  page?: string\n}\n\nexport default async function ProductsPage({\n  searchParams,\n}: {\n  searchParams: Promise\u003CSearchParams>\n}) {\n  const params = await searchParams\n\n  return (\n    \u003Cdiv className=\"flex gap-8\">\n      \u003CFilterSidebar \u002F>\n      \u003CSuspense\n        key={JSON.stringify(params)}\n        fallback={\u003CProductListSkeleton \u002F>}\n      >\n        \u003CProductList\n          category={params.category}\n          sort={params.sort}\n          page={Number(params.page) || 1}\n        \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F components\u002Fproducts\u002FProductList.tsx - Server Component\nasync function getProducts(filters: ProductFilters) {\n  const res = await fetch(\n    `${process.env.API_URL}\u002Fproducts?${new URLSearchParams(filters)}`,\n    { next: { tags: ['products'] } }\n  )\n  if (!res.ok) throw new Error('Failed to fetch products')\n  return res.json()\n}\n\nexport async function ProductList({ category, sort, page }: ProductFilters) {\n  const { products, totalPages } = await getProducts({ category, sort, page })\n\n  return (\n    \u003Cdiv>\n      \u003Cdiv className=\"grid grid-cols-3 gap-4\">\n        {products.map((product) => (\n          \u003CProductCard key={product.id} product={product} \u002F>\n        ))}\n      \u003C\u002Fdiv>\n      \u003CPagination currentPage={page} totalPages={totalPages} \u002F>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### Pattern 2: Client Components with 'use client'\n\n```typescript\n\u002F\u002F components\u002Fproducts\u002FAddToCartButton.tsx\n'use client'\n\nimport { useState, useTransition } from 'react'\nimport { addToCart } from '@\u002Fapp\u002Factions\u002Fcart'\n\nexport function AddToCartButton({ productId }: { productId: string }) {\n  const [isPending, startTransition] = useTransition()\n  const [error, setError] = useState\u003Cstring | null>(null)\n\n  const handleClick = () => {\n    setError(null)\n    startTransition(async () => {\n      const result = await addToCart(productId)\n      if (result.error) {\n        setError(result.error)\n      }\n    })\n  }\n\n  return (\n    \u003Cdiv>\n      \u003Cbutton\n        onClick={handleClick}\n        disabled={isPending}\n        className=\"btn-primary\"\n      >\n        {isPending ? 'Adding...' : 'Add to Cart'}\n      \u003C\u002Fbutton>\n      {error && \u003Cp className=\"text-red-500 text-sm\">{error}\u003C\u002Fp>}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### Pattern 3: Server Actions\n\n```typescript\n\u002F\u002F app\u002Factions\u002Fcart.ts\n'use server'\n\nimport { revalidateTag } from 'next\u002Fcache'\nimport { cookies } from 'next\u002Fheaders'\nimport { redirect } from 'next\u002Fnavigation'\n\nexport async function addToCart(productId: string) {\n  const cookieStore = await cookies()\n  const sessionId = cookieStore.get('session')?.value\n\n  if (!sessionId) {\n    redirect('\u002Flogin')\n  }\n\n  try {\n    await db.cart.upsert({\n      where: { sessionId_productId: { sessionId, productId } },\n      update: { quantity: { increment: 1 } },\n      create: { sessionId, productId, quantity: 1 },\n    })\n\n    revalidateTag('cart')\n    return { success: true }\n  } catch (error) {\n    return { error: 'Failed to add item to cart' }\n  }\n}\n\nexport async function checkout(formData: FormData) {\n  const address = formData.get('address') as string\n  const payment = formData.get('payment') as string\n\n  \u002F\u002F Validate\n  if (!address || !payment) {\n    return { error: 'Missing required fields' }\n  }\n\n  \u002F\u002F Process order\n  const order = await processOrder({ address, payment })\n\n  \u002F\u002F Redirect to confirmation\n  redirect(`\u002Forders\u002F${order.id}\u002Fconfirmation`)\n}\n```\n\n### Pattern 4: Parallel Routes\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Flayout.tsx\nexport default function DashboardLayout({\n  children,\n  analytics,\n  team,\n}: {\n  children: React.ReactNode\n  analytics: React.ReactNode\n  team: React.ReactNode\n}) {\n  return (\n    \u003Cdiv className=\"dashboard-grid\">\n      \u003Cmain>{children}\u003C\u002Fmain>\n      \u003Caside className=\"analytics-panel\">{analytics}\u003C\u002Faside>\n      \u003Caside className=\"team-panel\">{team}\u003C\u002Faside>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@analytics\u002Fpage.tsx\nexport default async function AnalyticsSlot() {\n  const stats = await getAnalytics()\n  return \u003CAnalyticsChart data={stats} \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@analytics\u002Floading.tsx\nexport default function AnalyticsLoading() {\n  return \u003CChartSkeleton \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@team\u002Fpage.tsx\nexport default async function TeamSlot() {\n  const members = await getTeamMembers()\n  return \u003CTeamList members={members} \u002F>\n}\n```\n\n### Pattern 5: Intercepting Routes (Modal Pattern)\n\n```typescript\n\u002F\u002F File structure for photo modal\n\u002F\u002F app\u002F\n\u002F\u002F ├── @modal\u002F\n\u002F\u002F │   ├── (.)photos\u002F[id]\u002Fpage.tsx  # Intercept\n\u002F\u002F │   └── default.tsx\n\u002F\u002F ├── photos\u002F\n\u002F\u002F │   └── [id]\u002Fpage.tsx            # Full page\n\u002F\u002F └── layout.tsx\n\n\u002F\u002F app\u002F@modal\u002F(.)photos\u002F[id]\u002Fpage.tsx\nimport { Modal } from '@\u002Fcomponents\u002FModal'\nimport { PhotoDetail } from '@\u002Fcomponents\u002FPhotoDetail'\n\nexport default async function PhotoModal({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n  const photo = await getPhoto(id)\n\n  return (\n    \u003CModal>\n      \u003CPhotoDetail photo={photo} \u002F>\n    \u003C\u002FModal>\n  )\n}\n\n\u002F\u002F app\u002Fphotos\u002F[id]\u002Fpage.tsx - Full page version\nexport default async function PhotoPage({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n  const photo = await getPhoto(id)\n\n  return (\n    \u003Cdiv className=\"photo-page\">\n      \u003CPhotoDetail photo={photo} \u002F>\n      \u003CRelatedPhotos photoId={id} \u002F>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F app\u002Flayout.tsx\nexport default function RootLayout({\n  children,\n  modal,\n}: {\n  children: React.ReactNode\n  modal: React.ReactNode\n}) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        {modal}\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Pattern 6: Streaming with Suspense\n\n```typescript\n\u002F\u002F app\u002Fproduct\u002F[id]\u002Fpage.tsx\nimport { Suspense } from 'react'\n\nexport default async function ProductPage({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n\n  \u002F\u002F This data loads first (blocking)\n  const product = await getProduct(id)\n\n  return (\n    \u003Cdiv>\n      {\u002F* Immediate render *\u002F}\n      \u003CProductHeader product={product} \u002F>\n\n      {\u002F* Stream in reviews *\u002F}\n      \u003CSuspense fallback={\u003CReviewsSkeleton \u002F>}>\n        \u003CReviews productId={id} \u002F>\n      \u003C\u002FSuspense>\n\n      {\u002F* Stream in recommendations *\u002F}\n      \u003CSuspense fallback={\u003CRecommendationsSkeleton \u002F>}>\n        \u003CRecommendations productId={id} \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F These components fetch their own data\nasync function Reviews({ productId }: { productId: string }) {\n  const reviews = await getReviews(productId) \u002F\u002F Slow API\n  return \u003CReviewList reviews={reviews} \u002F>\n}\n\nasync function Recommendations({ productId }: { productId: string }) {\n  const products = await getRecommendations(productId) \u002F\u002F ML-based, slow\n  return \u003CProductCarousel products={products} \u002F>\n}\n```\n\n### Pattern 7: Route Handlers (API Routes)\n\n```typescript\n\u002F\u002F app\u002Fapi\u002Fproducts\u002Froute.ts\nimport { NextRequest, NextResponse } from 'next\u002Fserver'\n\nexport async function GET(request: NextRequest) {\n  const searchParams = request.nextUrl.searchParams\n  const category = searchParams.get('category')\n\n  const products = await db.product.findMany({\n    where: category ? { category } : undefined,\n    take: 20,\n  })\n\n  return NextResponse.json(products)\n}\n\nexport async function POST(request: NextRequest) {\n  const body = await request.json()\n\n  const product = await db.product.create({\n    data: body,\n  })\n\n  return NextResponse.json(product, { status: 201 })\n}\n\n\u002F\u002F app\u002Fapi\u002Fproducts\u002F[id]\u002Froute.ts\nexport async function GET(\n  request: NextRequest,\n  { params }: { params: Promise\u003C{ id: string }> }\n) {\n  const { id } = await params\n  const product = await db.product.findUnique({ where: { id } })\n\n  if (!product) {\n    return NextResponse.json(\n      { error: 'Product not found' },\n      { status: 404 }\n    )\n  }\n\n  return NextResponse.json(product)\n}\n```\n\n### Pattern 8: Metadata and SEO\n\n```typescript\n\u002F\u002F app\u002Fproducts\u002F[slug]\u002Fpage.tsx\nimport { Metadata } from 'next'\nimport { notFound } from 'next\u002Fnavigation'\n\ntype Props = {\n  params: Promise\u003C{ slug: string }>\n}\n\nexport async function generateMetadata({ params }: Props): Promise\u003CMetadata> {\n  const { slug } = await params\n  const product = await getProduct(slug)\n\n  if (!product) return {}\n\n  return {\n    title: product.name,\n    description: product.description,\n    openGraph: {\n      title: product.name,\n      description: product.description,\n      images: [{ url: product.image, width: 1200, height: 630 }],\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title: product.name,\n      description: product.description,\n      images: [product.image],\n    },\n  }\n}\n\nexport async function generateStaticParams() {\n  const products = await db.product.findMany({ select: { slug: true } })\n  return products.map((p) => ({ slug: p.slug }))\n}\n\nexport default async function ProductPage({ params }: Props) {\n  const { slug } = await params\n  const product = await getProduct(slug)\n\n  if (!product) notFound()\n\n  return \u003CProductDetail product={product} \u002F>\n}\n```\n\n## Caching Strategies\n\n### Data Cache\n\n```typescript\n\u002F\u002F No cache (always fresh)\nfetch(url, { cache: 'no-store' })\n\n\u002F\u002F Cache forever (static)\nfetch(url, { cache: 'force-cache' })\n\n\u002F\u002F ISR - revalidate after 60 seconds\nfetch(url, { next: { revalidate: 60 } })\n\n\u002F\u002F Tag-based invalidation\nfetch(url, { next: { tags: ['products'] } })\n\n\u002F\u002F Invalidate via Server Action\n'use server'\nimport { revalidateTag, revalidatePath } from 'next\u002Fcache'\n\nexport async function updateProduct(id: string, data: ProductData) {\n  await db.product.update({ where: { id }, data })\n  revalidateTag('products')\n  revalidatePath('\u002Fproducts')\n}\n```\n\n## Best Practices\n\n### Do's\n- **Start with Server Components** - Add 'use client' only when needed\n- **Colocate data fetching** - Fetch data where it's used\n- **Use Suspense boundaries** - Enable streaming for slow data\n- **Leverage parallel routes** - Independent loading states\n- **Use Server Actions** - For mutations with progressive enhancement\n\n### Don'ts\n- **Don't pass serializable data** - Server → Client boundary limitations\n- **Don't use hooks in Server Components** - No useState, useEffect\n- **Don't fetch in Client Components** - Use Server Components or React Query\n- **Don't over-nest layouts** - Each layout adds to the component tree\n- **Don't ignore loading states** - Always provide loading.tsx or Suspense\n\n## Resources\n\n- [Next.js App Router Documentation](https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp)\n- [Server Components RFC](https:\u002F\u002Fgithub.com\u002Freactjs\u002Frfcs\u002Fblob\u002Fmain\u002Ftext\u002F0188-server-components.md)\n- [Vercel Templates](https:\u002F\u002Fvercel.com\u002Ftemplates\u002Fnext.js)\n","# Next.js App Router Patterns\n\nComprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.\n\n## When to Use This Skill\n\n- Building new Next.js applications with App Router\n- Migrating from Pages Router to App Router\n- Implementing Server Components and streaming\n- Setting up parallel and intercepting routes\n- Optimizing data fetching and caching\n- Building full-stack features with Server Actions\n\n## Core Concepts\n\n### 1. Rendering Modes\n\n| Mode | Where | When to Use |\n|------|-------|-------------|\n| **Server Components** | Server only | Data fetching, heavy computation, secrets |\n| **Client Components** | Browser | Interactivity, hooks, browser APIs |\n| **Static** | Build time | Content that rarely changes |\n| **Dynamic** | Request time | Personalized or real-time data |\n| **Streaming** | Progressive | Large pages, slow data sources |\n\n### 2. File Conventions\n\n```\napp\u002F\n├── layout.tsx       # Shared UI wrapper\n├── page.tsx         # Route UI\n├── loading.tsx      # Loading UI (Suspense)\n├── error.tsx        # Error boundary\n├── not-found.tsx    # 404 UI\n├── route.ts         # API endpoint\n├── template.tsx     # Re-mounted layout\n├── default.tsx      # Parallel route fallback\n└── opengraph-image.tsx  # OG image generation\n```\n\n## Quick Start\n\n```typescript\n\u002F\u002F app\u002Flayout.tsx\nimport { Inter } from 'next\u002Ffont\u002Fgoogle'\nimport { Providers } from '.\u002Fproviders'\n\nconst inter = Inter({ subsets: ['latin'] })\n\nexport const metadata = {\n  title: { default: 'My App', template: '%s | My App' },\n  description: 'Built with Next.js App Router',\n}\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode\n}) {\n  return (\n    \u003Chtml lang=\"en\" suppressHydrationWarning>\n      \u003Cbody className={inter.className}>\n        \u003CProviders>{children}\u003C\u002FProviders>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n\n\u002F\u002F app\u002Fpage.tsx - Server Component by default\nasync function getProducts() {\n  const res = await fetch('https:\u002F\u002Fapi.example.com\u002Fproducts', {\n    next: { revalidate: 3600 }, \u002F\u002F ISR: revalidate every hour\n  })\n  return res.json()\n}\n\nexport default async function HomePage() {\n  const products = await getProducts()\n\n  return (\n    \u003Cmain>\n      \u003Ch1>Products\u003C\u002Fh1>\n      \u003CProductGrid products={products} \u002F>\n    \u003C\u002Fmain>\n  )\n}\n```\n\n## Patterns\n\n### Pattern 1: Server Components with Data Fetching\n\n```typescript\n\u002F\u002F app\u002Fproducts\u002Fpage.tsx\nimport { Suspense } from 'react'\nimport { ProductList, ProductListSkeleton } from '@\u002Fcomponents\u002Fproducts'\nimport { FilterSidebar } from '@\u002Fcomponents\u002Ffilters'\n\ninterface SearchParams {\n  category?: string\n  sort?: 'price' | 'name' | 'date'\n  page?: string\n}\n\nexport default async function ProductsPage({\n  searchParams,\n}: {\n  searchParams: Promise\u003CSearchParams>\n}) {\n  const params = await searchParams\n\n  return (\n    \u003Cdiv className=\"flex gap-8\">\n      \u003CFilterSidebar \u002F>\n      \u003CSuspense\n        key={JSON.stringify(params)}\n        fallback={\u003CProductListSkeleton \u002F>}\n      >\n        \u003CProductList\n          category={params.category}\n          sort={params.sort}\n          page={Number(params.page) || 1}\n        \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F components\u002Fproducts\u002FProductList.tsx - Server Component\nasync function getProducts(filters: ProductFilters) {\n  const res = await fetch(\n    `${process.env.API_URL}\u002Fproducts?${new URLSearchParams(filters)}`,\n    { next: { tags: ['products'] } }\n  )\n  if (!res.ok) throw new Error('Failed to fetch products')\n  return res.json()\n}\n\nexport async function ProductList({ category, sort, page }: ProductFilters) {\n  const { products, totalPages } = await getProducts({ category, sort, page })\n\n  return (\n    \u003Cdiv>\n      \u003Cdiv className=\"grid grid-cols-3 gap-4\">\n        {products.map((product) => (\n          \u003CProductCard key={product.id} product={product} \u002F>\n        ))}\n      \u003C\u002Fdiv>\n      \u003CPagination currentPage={page} totalPages={totalPages} \u002F>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### Pattern 2: Client Components with 'use client'\n\n```typescript\n\u002F\u002F components\u002Fproducts\u002FAddToCartButton.tsx\n'use client'\n\nimport { useState, useTransition } from 'react'\nimport { addToCart } from '@\u002Fapp\u002Factions\u002Fcart'\n\nexport function AddToCartButton({ productId }: { productId: string }) {\n  const [isPending, startTransition] = useTransition()\n  const [error, setError] = useState\u003Cstring | null>(null)\n\n  const handleClick = () => {\n    setError(null)\n    startTransition(async () => {\n      const result = await addToCart(productId)\n      if (result.error) {\n        setError(result.error)\n      }\n    })\n  }\n\n  return (\n    \u003Cdiv>\n      \u003Cbutton\n        onClick={handleClick}\n        disabled={isPending}\n        className=\"btn-primary\"\n      >\n        {isPending ? 'Adding...' : 'Add to Cart'}\n      \u003C\u002Fbutton>\n      {error && \u003Cp className=\"text-red-500 text-sm\">{error}\u003C\u002Fp>}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### Pattern 3: Server Actions\n\n```typescript\n\u002F\u002F app\u002Factions\u002Fcart.ts\n'use server'\n\nimport { revalidateTag } from 'next\u002Fcache'\nimport { cookies } from 'next\u002Fheaders'\nimport { redirect } from 'next\u002Fnavigation'\n\nexport async function addToCart(productId: string) {\n  const cookieStore = await cookies()\n  const sessionId = cookieStore.get('session')?.value\n\n  if (!sessionId) {\n    redirect('\u002Flogin')\n  }\n\n  try {\n    await db.cart.upsert({\n      where: { sessionId_productId: { sessionId, productId } },\n      update: { quantity: { increment: 1 } },\n      create: { sessionId, productId, quantity: 1 },\n    })\n\n    revalidateTag('cart')\n    return { success: true }\n  } catch (error) {\n    return { error: 'Failed to add item to cart' }\n  }\n}\n\nexport async function checkout(formData: FormData) {\n  const address = formData.get('address') as string\n  const payment = formData.get('payment') as string\n\n  \u002F\u002F Validate\n  if (!address || !payment) {\n    return { error: 'Missing required fields' }\n  }\n\n  \u002F\u002F Process order\n  const order = await processOrder({ address, payment })\n\n  \u002F\u002F Redirect to confirmation\n  redirect(`\u002Forders\u002F${order.id}\u002Fconfirmation`)\n}\n```\n\n### Pattern 4: Parallel Routes\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Flayout.tsx\nexport default function DashboardLayout({\n  children,\n  analytics,\n  team,\n}: {\n  children: React.ReactNode\n  analytics: React.ReactNode\n  team: React.ReactNode\n}) {\n  return (\n    \u003Cdiv className=\"dashboard-grid\">\n      \u003Cmain>{children}\u003C\u002Fmain>\n      \u003Caside className=\"analytics-panel\">{analytics}\u003C\u002Faside>\n      \u003Caside className=\"team-panel\">{team}\u003C\u002Faside>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@analytics\u002Fpage.tsx\nexport default async function AnalyticsSlot() {\n  const stats = await getAnalytics()\n  return \u003CAnalyticsChart data={stats} \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@analytics\u002Floading.tsx\nexport default function AnalyticsLoading() {\n  return \u003CChartSkeleton \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002F@team\u002Fpage.tsx\nexport default async function TeamSlot() {\n  const members = await getTeamMembers()\n  return \u003CTeamList members={members} \u002F>\n}\n```\n\n### Pattern 5: Intercepting Routes (Modal Pattern)\n\n```typescript\n\u002F\u002F File structure for photo modal\n\u002F\u002F app\u002F\n\u002F\u002F ├── @modal\u002F\n\u002F\u002F │   ├── (.)photos\u002F[id]\u002Fpage.tsx  # Intercept\n\u002F\u002F │   └── default.tsx\n\u002F\u002F ├── photos\u002F\n\u002F\u002F │   └── [id]\u002Fpage.tsx            # Full page\n\u002F\u002F └── layout.tsx\n\n\u002F\u002F app\u002F@modal\u002F(.)photos\u002F[id]\u002Fpage.tsx\nimport { Modal } from '@\u002Fcomponents\u002FModal'\nimport { PhotoDetail } from '@\u002Fcomponents\u002FPhotoDetail'\n\nexport default async function PhotoModal({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n  const photo = await getPhoto(id)\n\n  return (\n    \u003CModal>\n      \u003CPhotoDetail photo={photo} \u002F>\n    \u003C\u002FModal>\n  )\n}\n\n\u002F\u002F app\u002Fphotos\u002F[id]\u002Fpage.tsx - Full page version\nexport default async function PhotoPage({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n  const photo = await getPhoto(id)\n\n  return (\n    \u003Cdiv className=\"photo-page\">\n      \u003CPhotoDetail photo={photo} \u002F>\n      \u003CRelatedPhotos photoId={id} \u002F>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F app\u002Flayout.tsx\nexport default function RootLayout({\n  children,\n  modal,\n}: {\n  children: React.ReactNode\n  modal: React.ReactNode\n}) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        {modal}\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Pattern 6: Streaming with Suspense\n\n```typescript\n\u002F\u002F app\u002Fproduct\u002F[id]\u002Fpage.tsx\nimport { Suspense } from 'react'\n\nexport default async function ProductPage({\n  params,\n}: {\n  params: Promise\u003C{ id: string }>\n}) {\n  const { id } = await params\n\n  \u002F\u002F This data loads first (blocking)\n  const product = await getProduct(id)\n\n  return (\n    \u003Cdiv>\n      {\u002F* Immediate render *\u002F}\n      \u003CProductHeader product={product} \u002F>\n\n      {\u002F* Stream in reviews *\u002F}\n      \u003CSuspense fallback={\u003CReviewsSkeleton \u002F>}>\n        \u003CReviews productId={id} \u002F>\n      \u003C\u002FSuspense>\n\n      {\u002F* Stream in recommendations *\u002F}\n      \u003CSuspense fallback={\u003CRecommendationsSkeleton \u002F>}>\n        \u003CRecommendations productId={id} \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\n\u002F\u002F These components fetch their own data\nasync function Reviews({ productId }: { productId: string }) {\n  const reviews = await getReviews(productId) \u002F\u002F Slow API\n  return \u003CReviewList reviews={reviews} \u002F>\n}\n\nasync function Recommendations({ productId }: { productId: string }) {\n  const products = await getRecommendations(productId) \u002F\u002F ML-based, slow\n  return \u003CProductCarousel products={products} \u002F>\n}\n```\n\n### Pattern 7: Route Handlers (API Routes)\n\n```typescript\n\u002F\u002F app\u002Fapi\u002Fproducts\u002Froute.ts\nimport { NextRequest, NextResponse } from 'next\u002Fserver'\n\nexport async function GET(request: NextRequest) {\n  const searchParams = request.nextUrl.searchParams\n  const category = searchParams.get('category')\n\n  const products = await db.product.findMany({\n    where: category ? { category } : undefined,\n    take: 20,\n  })\n\n  return NextResponse.json(products)\n}\n\nexport async function POST(request: NextRequest) {\n  const body = await request.json()\n\n  const product = await db.product.create({\n    data: body,\n  })\n\n  return NextResponse.json(product, { status: 201 })\n}\n\n\u002F\u002F app\u002Fapi\u002Fproducts\u002F[id]\u002Froute.ts\nexport async function GET(\n  request: NextRequest,\n  { params }: { params: Promise\u003C{ id: string }> }\n) {\n  const { id } = await params\n  const product = await db.product.findUnique({ where: { id } })\n\n  if (!product) {\n    return NextResponse.json(\n      { error: 'Product not found' },\n      { status: 404 }\n    )\n  }\n\n  return NextResponse.json(product)\n}\n```\n\n### Pattern 8: Metadata and SEO\n\n```typescript\n\u002F\u002F app\u002Fproducts\u002F[slug]\u002Fpage.tsx\nimport { Metadata } from 'next'\nimport { notFound } from 'next\u002Fnavigation'\n\ntype Props = {\n  params: Promise\u003C{ slug: string }>\n}\n\nexport async function generateMetadata({ params }: Props): Promise\u003CMetadata> {\n  const { slug } = await params\n  const product = await getProduct(slug)\n\n  if (!product) return {}\n\n  return {\n    title: product.name,\n    description: product.description,\n    openGraph: {\n      title: product.name,\n      description: product.description,\n      images: [{ url: product.image, width: 1200, height: 630 }],\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title: product.name,\n      description: product.description,\n      images: [product.image],\n    },\n  }\n}\n\nexport async function generateStaticParams() {\n  const products = await db.product.findMany({ select: { slug: true } })\n  return products.map((p) => ({ slug: p.slug }))\n}\n\nexport default async function ProductPage({ params }: Props) {\n  const { slug } = await params\n  const product = await getProduct(slug)\n\n  if (!product) notFound()\n\n  return \u003CProductDetail product={product} \u002F>\n}\n```\n\n## Caching Strategies\n\n### Data Cache\n\n```typescript\n\u002F\u002F No cache (always fresh)\nfetch(url, { cache: 'no-store' })\n\n\u002F\u002F Cache forever (static)\nfetch(url, { cache: 'force-cache' })\n\n\u002F\u002F ISR - revalidate after 60 seconds\nfetch(url, { next: { revalidate: 60 } })\n\n\u002F\u002F Tag-based invalidation\nfetch(url, { next: { tags: ['products'] } })\n\n\u002F\u002F Invalidate via Server Action\n'use server'\nimport { revalidateTag, revalidatePath } from 'next\u002Fcache'\n\nexport async function updateProduct(id: string, data: ProductData) {\n  await db.product.update({ where: { id }, data })\n  revalidateTag('products')\n  revalidatePath('\u002Fproducts')\n}\n```\n\n## Best Practices\n\n### Do's\n- **Start with Server Components** - Add 'use client' only when needed\n- **Colocate data fetching** - Fetch data where it's used\n- **Use Suspense boundaries** - Enable streaming for slow data\n- **Leverage parallel routes** - Independent loading states\n- **Use Server Actions** - For mutations with progressive enhancement\n\n### Don'ts\n- **Don't pass serializable data** - Server → Client boundary limitations\n- **Don't use hooks in Server Components** - No useState, useEffect\n- **Don't fetch in Client Components** - Use Server Components or React Query\n- **Don't over-nest layouts** - Each layout adds to the component tree\n- **Don't ignore loading states** - Always provide loading.tsx or Suspense\n\n## Resources\n\n- [Next.js App Router Documentation](https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp)\n- [Server Components RFC](https:\u002F\u002Fgithub.com\u002Freactjs\u002Frfcs\u002Fblob\u002Fmain\u002Ftext\u002F0188-server-components.md)\n- [Vercel Templates](https:\u002F\u002Fvercel.com\u002Ftemplates\u002Fnext.js)\n",{"name":5,"description":7},"main","18d0e63d1313ca87098f614aa7c1e2dcf6de79c7","backend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ffrontend-mobile-development\u002Fskills\u002Fnextjs-app-router-patterns",1,"https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system","https:\u002F\u002Fgithub.com\u002Fwelflau","2026-11-12 14:55:20",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add welflau\u002Fai-dev-system --skill nextjs-app-router-patterns",{"tool":63,"command":64},"bunx","bunx skills add welflau\u002Fai-dev-system --skill nextjs-app-router-patterns",{"tool":66,"command":67},"pnpm","pnpm dlx skills add welflau\u002Fai-dev-system --skill nextjs-app-router-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ffrontend-mobile-development\u002Fskills\u002Fnextjs-app-router-patterns\u002FSKILL.md",true,[],[72,104,134,158,187,212],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":86,"publishedAt":103},"01M6HS9Z4B0YA8CJCS2Y2F04Y3","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Fwebapp-testing\u002FSKILL.md",[80,83],{"categoryNo":81,"categoryName":82,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":84,"categoryName":85,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000009","前端开发",[87,88,89,90,91,92,93,94,95,96,97,98,39,99,100,101,102],"testing","webapp testing","webapp","frontend","screenshots","playwright","web","debugging","toolkit","browser","ui","logs","behavior","local","with","for","2026-11-11 15:11:14",{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":108,"sourceHtmlUrl":109,"categories":110,"keywords":114,"publishedAt":103},"01M6HRAGMG7JF0HXYHMA5QHS8A","internal-comms","A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Finternal-comms\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Finternal-comms\u002FSKILL.md",[111],{"categoryNo":112,"categoryName":113,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000005","邮件与沟通",[115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133],"internal comms","comms","status","help","SET","write","use","reports","me","incident","leadership","project","resources","communications","internal communications","formats","sort","my","updates",{"skillNo":135,"name":136,"nameZh":6,"description":137,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":138,"sourceHtmlUrl":139,"categories":140,"keywords":142,"publishedAt":45},"01M6HSTDP4M3JFXEBK91VFB4PA","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Fweb-artifacts-builder\u002FSKILL.md",[141],{"categoryNo":84,"categoryName":85,"taxonomyType":20,"taxonomyTypeDesc":21},[143,93,144,145,146,90,147,37,44,148,149,150,151,152,121,153,154,155,156,102,157],"web artifacts builder","artifacts","artifacts builder","builder","css","routing","state management","state","file","Tailwind","single-file","simple","ui components","multi","single",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":162,"sourceHtmlUrl":163,"categories":164,"keywords":174,"publishedAt":45},"01M6HSDXH0JSP8R3QTNY9XZ8HN","frontend-design","Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML\u002FCSS layouts, or when styling\u002Fbeautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Ffrontend-design\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Ffrontend-design\u002FSKILL.md",[165,166,169],{"categoryNo":84,"categoryName":85,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":167,"categoryName":168,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":170,"categoryName":171,"taxonomyType":172,"taxonomyTypeDesc":173},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[90,175,176,147,93,37,44,177,178,179,144,180,39,181,121,182,183,184,185,101,186,31],"design","frontend design","react components","create","code","examples","landing","ui design","pages","aesthetics","web ui","generic",{"skillNo":188,"name":189,"nameZh":6,"description":190,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":191,"sourceHtmlUrl":192,"categories":193,"keywords":195,"publishedAt":45},"01M6HSA77QYVP7A72HREGTDN2C","algorithmic-art","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Falgorithmic-art\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fplugins\u002Falgorithmic-art\u002FSKILL.md",[194],{"categoryNo":167,"categoryName":168,"taxonomyType":20,"taxonomyTypeDesc":21},[196,197,198,178,179,199,200,201,202,121,203,204,205,206,101,207,208,209,210,211,31],"algorithmic art","Art","algorithmic","flow","js","work","interactive","generative art","exploration","systems","users","Existing","request","generative","copyright","fields",{"skillNo":213,"name":214,"nameZh":6,"description":215,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":76,"licenseFileUrl":216,"sourceHtmlUrl":217,"categories":218,"keywords":220,"publishedAt":45},"01M6HS9HE0X390Y6RQKTY1YNGJ","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fwelflau\u002Fai-dev-system\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fmarketplace\u002Fcodebuddy-plugins-official\u002Fexternal_plugins\u002Ftheme-factory\u002FSKILL.md",[219],{"categoryNo":167,"categoryName":168,"taxonomyType":20,"taxonomyTypeDesc":21},[221,222,223,224,95,225,144,119,226,227,181,228,229,183,230,101,231,232,233,102,234,235],"theme factory","factory","theme","docs","generate","fly","slides","styling","artifact","themes","you","fonts","can","apply","new"]