nextjs
Layer 2 — Framework Pack
Next.js 14/15 App Router patterns. Server components, data fetching, caching,
server actions, and the specific mistakes agents make from Pages Router
training data contamination.
Philosophy
Next.js is where the "judgment not knowledge" principle matters most. The
framework underwent a fundamental paradigm shift from Pages Router to App Router.
Server components changed how data fetching works. Server actions changed how
mutations work. The caching model changed between Next.js 14 and 15.
LLMs trained on pre-App-Router content produce code that technically runs but
uses wrong patterns — getServerSideProps in App Router projects, useEffect
for data fetching that should happen on the server, 'use client' on every
component because the agent doesn't understand the server-first model.
This pack establishes the App Router mental model as the default and explicitly
corrects the most common Pages Router contamination patterns.
What's Included
| Type |
Files |
Coverage |
| Patterns |
7 |
Server components, data fetching, routing/layouts, server actions, caching, middleware, metadata |
| Anti-patterns |
5 |
Pages Router patterns, use-client-everywhere, useEffect data fetching, client-side routing, wrong caching |
| Constitution |
1 |
6 Next.js-specific principles |
| Gate |
1 |
Next.js pattern compliance check |
Overrides
When installed alongside react, this pack overrides React's
data-fetching pattern. In Next.js, data fetching happens in server components,
not via TanStack Query in client components (unless you specifically need
client-side real-time data).
Key Mental Model
Server-first. Components are server components by default. They run on the
server, have direct access to databases and file systems, and ship zero JavaScript
to the browser. Only add 'use client' when you need interactivity (event handlers,
hooks, browser APIs). Most components (70-90% in a typical app) should remain
server components.
Stack Integrations (detection-gated)
Next.js rarely ships alone. When a dependency below is detected, read the
matching integration reference — the cross-framework seams that neither tool's
own docs cover. These fold in the former stack-nextjs-supabase and
stack-nextjs-fullstack skills; the content is unchanged, now surfaced through
nextjs on detection.
@supabase/ssr / @supabase/supabase-js → integration/supabase-integration.md
— dual browser/server clients, middleware token refresh, RLS as authorization,
typed queries, Server Actions.
Constitution: constitution/supabase.constitution-additions.md ·
anti-patterns: anti-patterns/supabase-anti-patterns.md.
prisma + tailwindcss (+ Auth.js) → integration/fullstack-integration.md
— Prisma client singleton, Auth.js × App Router middleware, Tailwind × server
components.
Constitution: constitution/fullstack.constitution-additions.md ·
anti-patterns: anti-patterns/fullstack-anti-patterns.md.
1---2name: "nextjs"3description: "Use when writing or reviewing a Next.js App Router project — choosing server or client components, fetching and caching data, server actions, or route handlers."4version: "1.0.0"5type: knowledge6layer: framework7requires:8 sage: ">=1.0.0"9 skills:10 - "web"11 - "react"12activates-when:13 detected: [next, "@supabase/ssr", "@supabase/supabase-js", prisma, tailwindcss]14tags: [next, supabase, prisma, tailwindcss, fullstack]15metadata:16 source: https://skillmd.com/skills/xoai/nextjs17---1819# nextjs2021**Layer 2 — Framework Pack**2223Next.js 14/15 App Router patterns. Server components, data fetching, caching,24server actions, and the specific mistakes agents make from Pages Router25training data contamination.2627## Philosophy2829Next.js is where the "judgment not knowledge" principle matters most. The30framework underwent a fundamental paradigm shift from Pages Router to App Router.31Server components changed how data fetching works. Server actions changed how32mutations work. The caching model changed between Next.js 14 and 15.3334LLMs trained on pre-App-Router content produce code that technically runs but35uses wrong patterns — `getServerSideProps` in App Router projects, `useEffect`36for data fetching that should happen on the server, `'use client'` on every37component because the agent doesn't understand the server-first model.3839This pack establishes the App Router mental model as the default and explicitly40corrects the most common Pages Router contamination patterns.4142## What's Included4344| Type | Files | Coverage |45|------|-------|----------|46| Patterns | 7 | Server components, data fetching, routing/layouts, server actions, caching, middleware, metadata |47| Anti-patterns | 5 | Pages Router patterns, use-client-everywhere, useEffect data fetching, client-side routing, wrong caching |48| Constitution | 1 | 6 Next.js-specific principles |49| Gate | 1 | Next.js pattern compliance check |5051## Overrides5253When installed alongside `react`, this pack overrides React's54data-fetching pattern. In Next.js, data fetching happens in server components,55not via TanStack Query in client components (unless you specifically need56client-side real-time data).5758## Key Mental Model5960**Server-first.** Components are server components by default. They run on the61server, have direct access to databases and file systems, and ship zero JavaScript62to the browser. Only add `'use client'` when you need interactivity (event handlers,63hooks, browser APIs). Most components (70-90% in a typical app) should remain64server components.6566## Stack Integrations (detection-gated)6768Next.js rarely ships alone. When a dependency below is detected, read the69matching integration reference — the cross-framework seams that neither tool's70own docs cover. These fold in the former `stack-nextjs-supabase` and71`stack-nextjs-fullstack` skills; the content is unchanged, now surfaced through72`nextjs` on detection.7374- **`@supabase/ssr` / `@supabase/supabase-js`** → `integration/supabase-integration.md`75 — dual browser/server clients, middleware token refresh, RLS as authorization,76 typed queries, Server Actions.77 Constitution: `constitution/supabase.constitution-additions.md` ·78 anti-patterns: `anti-patterns/supabase-anti-patterns.md`.79- **`prisma` + `tailwindcss` (+ Auth.js)** → `integration/fullstack-integration.md`80 — Prisma client singleton, Auth.js × App Router middleware, Tailwind × server81 components.82 Constitution: `constitution/fullstack.constitution-additions.md` ·83 anti-patterns: `anti-patterns/fullstack-anti-patterns.md`.