[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-vercel-next-best-practices":3,"mdc-l5g8ra-key":31,"related-repo-vercel-next-best-practices":1059,"related-org-vercel-next-best-practices":1172},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":26,"sourceUrl":29,"mdContent":30},"next-best-practices","implement Next.js best practices","Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image\u002Ffont optimization, bundling",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"vercel","Vercel","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fvercel.png",[12,16,17],{"name":13,"slug":14,"type":15},"Performance","performance","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Next.js","next-js",226,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fvercel-plugin","2026-04-06T18:56:53.822191",null,36,[],{"repoUrl":21,"stars":20,"forks":24,"topics":27,"description":28},[],"Comprehensive Vercel ecosystem plugin — relational knowledge graph, skills for every major product, specialized agents, and Vercel conventions. Turns any AI agent into a Vercel expert.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fvercel-plugin\u002Ftree\u002FHEAD\u002Fskills\u002Fnextjs\u002Fupstream","---\nname: next-best-practices\ndescription: Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image\u002Ffont optimization, bundling\nuser-invocable: false\n---\n\n# Next.js Best Practices\n\nApply these rules when writing or reviewing Next.js code.\n\n## File Conventions\n\nSee [file-conventions.md](.\u002Ffile-conventions.md) for:\n- Project structure and special files\n- Route segments (dynamic, catch-all, groups)\n- Parallel and intercepting routes\n- Middleware rename in v16 (middleware → proxy)\n\n## RSC Boundaries\n\nDetect invalid React Server Component patterns.\n\nSee [rsc-boundaries.md](.\u002Frsc-boundaries.md) for:\n- Async client component detection (invalid)\n- Non-serializable props detection\n- Server Action exceptions\n\n## Async Patterns\n\nNext.js 15+ async API changes.\n\nSee [async-patterns.md](.\u002Fasync-patterns.md) for:\n- Async `params` and `searchParams`\n- Async `cookies()` and `headers()`\n- Migration codemod\n\n## Runtime Selection\n\nSee [runtime-selection.md](.\u002Fruntime-selection.md) for:\n- Default to Node.js runtime\n- When Edge runtime is appropriate\n\n## Directives\n\nSee [directives.md](.\u002Fdirectives.md) for:\n- `'use client'`, `'use server'` (React)\n- `'use cache'` (Next.js)\n\n## Functions\n\nSee [functions.md](.\u002Ffunctions.md) for:\n- Navigation hooks: `useRouter`, `usePathname`, `useSearchParams`, `useParams`\n- Server functions: `cookies`, `headers`, `draftMode`, `after`\n- Generate functions: `generateStaticParams`, `generateMetadata`\n\n## Error Handling\n\nSee [error-handling.md](.\u002Ferror-handling.md) for:\n- `error.tsx`, `global-error.tsx`, `not-found.tsx`\n- `redirect`, `permanentRedirect`, `notFound`\n- `forbidden`, `unauthorized` (auth errors)\n- `unstable_rethrow` for catch blocks\n\n## Data Patterns\n\nSee [data-patterns.md](.\u002Fdata-patterns.md) for:\n- Server Components vs Server Actions vs Route Handlers\n- Avoiding data waterfalls (`Promise.all`, Suspense, preload)\n- Client component data fetching\n\n## Route Handlers\n\nSee [route-handlers.md](.\u002Froute-handlers.md) for:\n- `route.ts` basics\n- GET handler conflicts with `page.tsx`\n- Environment behavior (no React DOM)\n- When to use vs Server Actions\n\n## Metadata & OG Images\n\nSee [metadata.md](.\u002Fmetadata.md) for:\n- Static and dynamic metadata\n- `generateMetadata` function\n- OG image generation with `next\u002Fog`\n- File-based metadata conventions\n\n## Image Optimization\n\nSee [image.md](.\u002Fimage.md) for:\n- Always use `next\u002Fimage` over `\u003Cimg>`\n- Remote images configuration\n- Responsive `sizes` attribute\n- Blur placeholders\n- Priority loading for LCP\n\n## Font Optimization\n\nSee [font.md](.\u002Ffont.md) for:\n- `next\u002Ffont` setup\n- Google Fonts, local fonts\n- Tailwind CSS integration\n- Preloading subsets\n\n## Bundling\n\nSee [bundling.md](.\u002Fbundling.md) for:\n- Server-incompatible packages\n- CSS imports (not link tags)\n- Polyfills (already included)\n- ESM\u002FCommonJS issues\n- Bundle analysis\n\n## Scripts\n\nSee [scripts.md](.\u002Fscripts.md) for:\n- `next\u002Fscript` vs native script tags\n- Inline scripts need `id`\n- Loading strategies\n- Google Analytics with `@next\u002Fthird-parties`\n\n## Hydration Errors\n\nSee [hydration-error.md](.\u002Fhydration-error.md) for:\n- Common causes (browser APIs, dates, invalid HTML)\n- Debugging with error overlay\n- Fixes for each cause\n\n## Suspense Boundaries\n\nSee [suspense-boundaries.md](.\u002Fsuspense-boundaries.md) for:\n- CSR bailout with `useSearchParams` and `usePathname`\n- Which hooks require Suspense boundaries\n\n## Parallel & Intercepting Routes\n\nSee [parallel-routes.md](.\u002Fparallel-routes.md) for:\n- Modal patterns with `@slot` and `(.)` interceptors\n- `default.tsx` for fallbacks\n- Closing modals correctly with `router.back()`\n\n## Self-Hosting\n\nSee [self-hosting.md](.\u002Fself-hosting.md) for:\n- `output: 'standalone'` for Docker\n- Cache handlers for multi-instance ISR\n- What works vs needs extra setup\n\n## Debug Tricks\n\nSee [debug-tricks.md](.\u002Fdebug-tricks.md) for:\n- MCP endpoint for AI-assisted debugging\n- Rebuild specific routes with `--debug-build-paths`\n\n",{"data":32,"body":34},{"name":4,"description":6,"user-invocable":33},false,{"type":35,"children":36},"root",[37,46,52,59,73,98,104,109,120,138,144,149,160,205,211,222,235,241,252,285,291,302,387,393,404,482,488,499,525,531,542,577,583,594,628,634,645,695,701,712,741,747,758,786,792,803,844,850,861,879,885,896,920,926,937,982,988,999,1023,1029,1040],{"type":38,"tag":39,"props":40,"children":42},"element","h1",{"id":41},"nextjs-best-practices",[43],{"type":44,"value":45},"text","Next.js Best Practices",{"type":38,"tag":47,"props":48,"children":49},"p",{},[50],{"type":44,"value":51},"Apply these rules when writing or reviewing Next.js code.",{"type":38,"tag":53,"props":54,"children":56},"h2",{"id":55},"file-conventions",[57],{"type":44,"value":58},"File Conventions",{"type":38,"tag":47,"props":60,"children":61},{},[62,64,71],{"type":44,"value":63},"See ",{"type":38,"tag":65,"props":66,"children":68},"a",{"href":67},".\u002Ffile-conventions.md",[69],{"type":44,"value":70},"file-conventions.md",{"type":44,"value":72}," for:",{"type":38,"tag":74,"props":75,"children":76},"ul",{},[77,83,88,93],{"type":38,"tag":78,"props":79,"children":80},"li",{},[81],{"type":44,"value":82},"Project structure and special files",{"type":38,"tag":78,"props":84,"children":85},{},[86],{"type":44,"value":87},"Route segments (dynamic, catch-all, groups)",{"type":38,"tag":78,"props":89,"children":90},{},[91],{"type":44,"value":92},"Parallel and intercepting routes",{"type":38,"tag":78,"props":94,"children":95},{},[96],{"type":44,"value":97},"Middleware rename in v16 (middleware → proxy)",{"type":38,"tag":53,"props":99,"children":101},{"id":100},"rsc-boundaries",[102],{"type":44,"value":103},"RSC Boundaries",{"type":38,"tag":47,"props":105,"children":106},{},[107],{"type":44,"value":108},"Detect invalid React Server Component patterns.",{"type":38,"tag":47,"props":110,"children":111},{},[112,113,119],{"type":44,"value":63},{"type":38,"tag":65,"props":114,"children":116},{"href":115},".\u002Frsc-boundaries.md",[117],{"type":44,"value":118},"rsc-boundaries.md",{"type":44,"value":72},{"type":38,"tag":74,"props":121,"children":122},{},[123,128,133],{"type":38,"tag":78,"props":124,"children":125},{},[126],{"type":44,"value":127},"Async client component detection (invalid)",{"type":38,"tag":78,"props":129,"children":130},{},[131],{"type":44,"value":132},"Non-serializable props detection",{"type":38,"tag":78,"props":134,"children":135},{},[136],{"type":44,"value":137},"Server Action exceptions",{"type":38,"tag":53,"props":139,"children":141},{"id":140},"async-patterns",[142],{"type":44,"value":143},"Async Patterns",{"type":38,"tag":47,"props":145,"children":146},{},[147],{"type":44,"value":148},"Next.js 15+ async API changes.",{"type":38,"tag":47,"props":150,"children":151},{},[152,153,159],{"type":44,"value":63},{"type":38,"tag":65,"props":154,"children":156},{"href":155},".\u002Fasync-patterns.md",[157],{"type":44,"value":158},"async-patterns.md",{"type":44,"value":72},{"type":38,"tag":74,"props":161,"children":162},{},[163,183,200],{"type":38,"tag":78,"props":164,"children":165},{},[166,168,175,177],{"type":44,"value":167},"Async ",{"type":38,"tag":169,"props":170,"children":172},"code",{"className":171},[],[173],{"type":44,"value":174},"params",{"type":44,"value":176}," and ",{"type":38,"tag":169,"props":178,"children":180},{"className":179},[],[181],{"type":44,"value":182},"searchParams",{"type":38,"tag":78,"props":184,"children":185},{},[186,187,193,194],{"type":44,"value":167},{"type":38,"tag":169,"props":188,"children":190},{"className":189},[],[191],{"type":44,"value":192},"cookies()",{"type":44,"value":176},{"type":38,"tag":169,"props":195,"children":197},{"className":196},[],[198],{"type":44,"value":199},"headers()",{"type":38,"tag":78,"props":201,"children":202},{},[203],{"type":44,"value":204},"Migration codemod",{"type":38,"tag":53,"props":206,"children":208},{"id":207},"runtime-selection",[209],{"type":44,"value":210},"Runtime Selection",{"type":38,"tag":47,"props":212,"children":213},{},[214,215,221],{"type":44,"value":63},{"type":38,"tag":65,"props":216,"children":218},{"href":217},".\u002Fruntime-selection.md",[219],{"type":44,"value":220},"runtime-selection.md",{"type":44,"value":72},{"type":38,"tag":74,"props":223,"children":224},{},[225,230],{"type":38,"tag":78,"props":226,"children":227},{},[228],{"type":44,"value":229},"Default to Node.js runtime",{"type":38,"tag":78,"props":231,"children":232},{},[233],{"type":44,"value":234},"When Edge runtime is appropriate",{"type":38,"tag":53,"props":236,"children":238},{"id":237},"directives",[239],{"type":44,"value":240},"Directives",{"type":38,"tag":47,"props":242,"children":243},{},[244,245,251],{"type":44,"value":63},{"type":38,"tag":65,"props":246,"children":248},{"href":247},".\u002Fdirectives.md",[249],{"type":44,"value":250},"directives.md",{"type":44,"value":72},{"type":38,"tag":74,"props":253,"children":254},{},[255,274],{"type":38,"tag":78,"props":256,"children":257},{},[258,264,266,272],{"type":38,"tag":169,"props":259,"children":261},{"className":260},[],[262],{"type":44,"value":263},"'use client'",{"type":44,"value":265},", ",{"type":38,"tag":169,"props":267,"children":269},{"className":268},[],[270],{"type":44,"value":271},"'use server'",{"type":44,"value":273}," (React)",{"type":38,"tag":78,"props":275,"children":276},{},[277,283],{"type":38,"tag":169,"props":278,"children":280},{"className":279},[],[281],{"type":44,"value":282},"'use cache'",{"type":44,"value":284}," (Next.js)",{"type":38,"tag":53,"props":286,"children":288},{"id":287},"functions",[289],{"type":44,"value":290},"Functions",{"type":38,"tag":47,"props":292,"children":293},{},[294,295,301],{"type":44,"value":63},{"type":38,"tag":65,"props":296,"children":298},{"href":297},".\u002Ffunctions.md",[299],{"type":44,"value":300},"functions.md",{"type":44,"value":72},{"type":38,"tag":74,"props":303,"children":304},{},[305,337,369],{"type":38,"tag":78,"props":306,"children":307},{},[308,310,316,317,323,324,330,331],{"type":44,"value":309},"Navigation hooks: ",{"type":38,"tag":169,"props":311,"children":313},{"className":312},[],[314],{"type":44,"value":315},"useRouter",{"type":44,"value":265},{"type":38,"tag":169,"props":318,"children":320},{"className":319},[],[321],{"type":44,"value":322},"usePathname",{"type":44,"value":265},{"type":38,"tag":169,"props":325,"children":327},{"className":326},[],[328],{"type":44,"value":329},"useSearchParams",{"type":44,"value":265},{"type":38,"tag":169,"props":332,"children":334},{"className":333},[],[335],{"type":44,"value":336},"useParams",{"type":38,"tag":78,"props":338,"children":339},{},[340,342,348,349,355,356,362,363],{"type":44,"value":341},"Server functions: ",{"type":38,"tag":169,"props":343,"children":345},{"className":344},[],[346],{"type":44,"value":347},"cookies",{"type":44,"value":265},{"type":38,"tag":169,"props":350,"children":352},{"className":351},[],[353],{"type":44,"value":354},"headers",{"type":44,"value":265},{"type":38,"tag":169,"props":357,"children":359},{"className":358},[],[360],{"type":44,"value":361},"draftMode",{"type":44,"value":265},{"type":38,"tag":169,"props":364,"children":366},{"className":365},[],[367],{"type":44,"value":368},"after",{"type":38,"tag":78,"props":370,"children":371},{},[372,374,380,381],{"type":44,"value":373},"Generate functions: ",{"type":38,"tag":169,"props":375,"children":377},{"className":376},[],[378],{"type":44,"value":379},"generateStaticParams",{"type":44,"value":265},{"type":38,"tag":169,"props":382,"children":384},{"className":383},[],[385],{"type":44,"value":386},"generateMetadata",{"type":38,"tag":53,"props":388,"children":390},{"id":389},"error-handling",[391],{"type":44,"value":392},"Error Handling",{"type":38,"tag":47,"props":394,"children":395},{},[396,397,403],{"type":44,"value":63},{"type":38,"tag":65,"props":398,"children":400},{"href":399},".\u002Ferror-handling.md",[401],{"type":44,"value":402},"error-handling.md",{"type":44,"value":72},{"type":38,"tag":74,"props":405,"children":406},{},[407,430,453,471],{"type":38,"tag":78,"props":408,"children":409},{},[410,416,417,423,424],{"type":38,"tag":169,"props":411,"children":413},{"className":412},[],[414],{"type":44,"value":415},"error.tsx",{"type":44,"value":265},{"type":38,"tag":169,"props":418,"children":420},{"className":419},[],[421],{"type":44,"value":422},"global-error.tsx",{"type":44,"value":265},{"type":38,"tag":169,"props":425,"children":427},{"className":426},[],[428],{"type":44,"value":429},"not-found.tsx",{"type":38,"tag":78,"props":431,"children":432},{},[433,439,440,446,447],{"type":38,"tag":169,"props":434,"children":436},{"className":435},[],[437],{"type":44,"value":438},"redirect",{"type":44,"value":265},{"type":38,"tag":169,"props":441,"children":443},{"className":442},[],[444],{"type":44,"value":445},"permanentRedirect",{"type":44,"value":265},{"type":38,"tag":169,"props":448,"children":450},{"className":449},[],[451],{"type":44,"value":452},"notFound",{"type":38,"tag":78,"props":454,"children":455},{},[456,462,463,469],{"type":38,"tag":169,"props":457,"children":459},{"className":458},[],[460],{"type":44,"value":461},"forbidden",{"type":44,"value":265},{"type":38,"tag":169,"props":464,"children":466},{"className":465},[],[467],{"type":44,"value":468},"unauthorized",{"type":44,"value":470}," (auth errors)",{"type":38,"tag":78,"props":472,"children":473},{},[474,480],{"type":38,"tag":169,"props":475,"children":477},{"className":476},[],[478],{"type":44,"value":479},"unstable_rethrow",{"type":44,"value":481}," for catch blocks",{"type":38,"tag":53,"props":483,"children":485},{"id":484},"data-patterns",[486],{"type":44,"value":487},"Data Patterns",{"type":38,"tag":47,"props":489,"children":490},{},[491,492,498],{"type":44,"value":63},{"type":38,"tag":65,"props":493,"children":495},{"href":494},".\u002Fdata-patterns.md",[496],{"type":44,"value":497},"data-patterns.md",{"type":44,"value":72},{"type":38,"tag":74,"props":500,"children":501},{},[502,507,520],{"type":38,"tag":78,"props":503,"children":504},{},[505],{"type":44,"value":506},"Server Components vs Server Actions vs Route Handlers",{"type":38,"tag":78,"props":508,"children":509},{},[510,512,518],{"type":44,"value":511},"Avoiding data waterfalls (",{"type":38,"tag":169,"props":513,"children":515},{"className":514},[],[516],{"type":44,"value":517},"Promise.all",{"type":44,"value":519},", Suspense, preload)",{"type":38,"tag":78,"props":521,"children":522},{},[523],{"type":44,"value":524},"Client component data fetching",{"type":38,"tag":53,"props":526,"children":528},{"id":527},"route-handlers",[529],{"type":44,"value":530},"Route Handlers",{"type":38,"tag":47,"props":532,"children":533},{},[534,535,541],{"type":44,"value":63},{"type":38,"tag":65,"props":536,"children":538},{"href":537},".\u002Froute-handlers.md",[539],{"type":44,"value":540},"route-handlers.md",{"type":44,"value":72},{"type":38,"tag":74,"props":543,"children":544},{},[545,556,567,572],{"type":38,"tag":78,"props":546,"children":547},{},[548,554],{"type":38,"tag":169,"props":549,"children":551},{"className":550},[],[552],{"type":44,"value":553},"route.ts",{"type":44,"value":555}," basics",{"type":38,"tag":78,"props":557,"children":558},{},[559,561],{"type":44,"value":560},"GET handler conflicts with ",{"type":38,"tag":169,"props":562,"children":564},{"className":563},[],[565],{"type":44,"value":566},"page.tsx",{"type":38,"tag":78,"props":568,"children":569},{},[570],{"type":44,"value":571},"Environment behavior (no React DOM)",{"type":38,"tag":78,"props":573,"children":574},{},[575],{"type":44,"value":576},"When to use vs Server Actions",{"type":38,"tag":53,"props":578,"children":580},{"id":579},"metadata-og-images",[581],{"type":44,"value":582},"Metadata & OG Images",{"type":38,"tag":47,"props":584,"children":585},{},[586,587,593],{"type":44,"value":63},{"type":38,"tag":65,"props":588,"children":590},{"href":589},".\u002Fmetadata.md",[591],{"type":44,"value":592},"metadata.md",{"type":44,"value":72},{"type":38,"tag":74,"props":595,"children":596},{},[597,602,612,623],{"type":38,"tag":78,"props":598,"children":599},{},[600],{"type":44,"value":601},"Static and dynamic metadata",{"type":38,"tag":78,"props":603,"children":604},{},[605,610],{"type":38,"tag":169,"props":606,"children":608},{"className":607},[],[609],{"type":44,"value":386},{"type":44,"value":611}," function",{"type":38,"tag":78,"props":613,"children":614},{},[615,617],{"type":44,"value":616},"OG image generation with ",{"type":38,"tag":169,"props":618,"children":620},{"className":619},[],[621],{"type":44,"value":622},"next\u002Fog",{"type":38,"tag":78,"props":624,"children":625},{},[626],{"type":44,"value":627},"File-based metadata conventions",{"type":38,"tag":53,"props":629,"children":631},{"id":630},"image-optimization",[632],{"type":44,"value":633},"Image Optimization",{"type":38,"tag":47,"props":635,"children":636},{},[637,638,644],{"type":44,"value":63},{"type":38,"tag":65,"props":639,"children":641},{"href":640},".\u002Fimage.md",[642],{"type":44,"value":643},"image.md",{"type":44,"value":72},{"type":38,"tag":74,"props":646,"children":647},{},[648,667,672,685,690],{"type":38,"tag":78,"props":649,"children":650},{},[651,653,659,661],{"type":44,"value":652},"Always use ",{"type":38,"tag":169,"props":654,"children":656},{"className":655},[],[657],{"type":44,"value":658},"next\u002Fimage",{"type":44,"value":660}," over ",{"type":38,"tag":169,"props":662,"children":664},{"className":663},[],[665],{"type":44,"value":666},"\u003Cimg>",{"type":38,"tag":78,"props":668,"children":669},{},[670],{"type":44,"value":671},"Remote images configuration",{"type":38,"tag":78,"props":673,"children":674},{},[675,677,683],{"type":44,"value":676},"Responsive ",{"type":38,"tag":169,"props":678,"children":680},{"className":679},[],[681],{"type":44,"value":682},"sizes",{"type":44,"value":684}," attribute",{"type":38,"tag":78,"props":686,"children":687},{},[688],{"type":44,"value":689},"Blur placeholders",{"type":38,"tag":78,"props":691,"children":692},{},[693],{"type":44,"value":694},"Priority loading for LCP",{"type":38,"tag":53,"props":696,"children":698},{"id":697},"font-optimization",[699],{"type":44,"value":700},"Font Optimization",{"type":38,"tag":47,"props":702,"children":703},{},[704,705,711],{"type":44,"value":63},{"type":38,"tag":65,"props":706,"children":708},{"href":707},".\u002Ffont.md",[709],{"type":44,"value":710},"font.md",{"type":44,"value":72},{"type":38,"tag":74,"props":713,"children":714},{},[715,726,731,736],{"type":38,"tag":78,"props":716,"children":717},{},[718,724],{"type":38,"tag":169,"props":719,"children":721},{"className":720},[],[722],{"type":44,"value":723},"next\u002Ffont",{"type":44,"value":725}," setup",{"type":38,"tag":78,"props":727,"children":728},{},[729],{"type":44,"value":730},"Google Fonts, local fonts",{"type":38,"tag":78,"props":732,"children":733},{},[734],{"type":44,"value":735},"Tailwind CSS integration",{"type":38,"tag":78,"props":737,"children":738},{},[739],{"type":44,"value":740},"Preloading subsets",{"type":38,"tag":53,"props":742,"children":744},{"id":743},"bundling",[745],{"type":44,"value":746},"Bundling",{"type":38,"tag":47,"props":748,"children":749},{},[750,751,757],{"type":44,"value":63},{"type":38,"tag":65,"props":752,"children":754},{"href":753},".\u002Fbundling.md",[755],{"type":44,"value":756},"bundling.md",{"type":44,"value":72},{"type":38,"tag":74,"props":759,"children":760},{},[761,766,771,776,781],{"type":38,"tag":78,"props":762,"children":763},{},[764],{"type":44,"value":765},"Server-incompatible packages",{"type":38,"tag":78,"props":767,"children":768},{},[769],{"type":44,"value":770},"CSS imports (not link tags)",{"type":38,"tag":78,"props":772,"children":773},{},[774],{"type":44,"value":775},"Polyfills (already included)",{"type":38,"tag":78,"props":777,"children":778},{},[779],{"type":44,"value":780},"ESM\u002FCommonJS issues",{"type":38,"tag":78,"props":782,"children":783},{},[784],{"type":44,"value":785},"Bundle analysis",{"type":38,"tag":53,"props":787,"children":789},{"id":788},"scripts",[790],{"type":44,"value":791},"Scripts",{"type":38,"tag":47,"props":793,"children":794},{},[795,796,802],{"type":44,"value":63},{"type":38,"tag":65,"props":797,"children":799},{"href":798},".\u002Fscripts.md",[800],{"type":44,"value":801},"scripts.md",{"type":44,"value":72},{"type":38,"tag":74,"props":804,"children":805},{},[806,817,828,833],{"type":38,"tag":78,"props":807,"children":808},{},[809,815],{"type":38,"tag":169,"props":810,"children":812},{"className":811},[],[813],{"type":44,"value":814},"next\u002Fscript",{"type":44,"value":816}," vs native script tags",{"type":38,"tag":78,"props":818,"children":819},{},[820,822],{"type":44,"value":821},"Inline scripts need ",{"type":38,"tag":169,"props":823,"children":825},{"className":824},[],[826],{"type":44,"value":827},"id",{"type":38,"tag":78,"props":829,"children":830},{},[831],{"type":44,"value":832},"Loading strategies",{"type":38,"tag":78,"props":834,"children":835},{},[836,838],{"type":44,"value":837},"Google Analytics with ",{"type":38,"tag":169,"props":839,"children":841},{"className":840},[],[842],{"type":44,"value":843},"@next\u002Fthird-parties",{"type":38,"tag":53,"props":845,"children":847},{"id":846},"hydration-errors",[848],{"type":44,"value":849},"Hydration Errors",{"type":38,"tag":47,"props":851,"children":852},{},[853,854,860],{"type":44,"value":63},{"type":38,"tag":65,"props":855,"children":857},{"href":856},".\u002Fhydration-error.md",[858],{"type":44,"value":859},"hydration-error.md",{"type":44,"value":72},{"type":38,"tag":74,"props":862,"children":863},{},[864,869,874],{"type":38,"tag":78,"props":865,"children":866},{},[867],{"type":44,"value":868},"Common causes (browser APIs, dates, invalid HTML)",{"type":38,"tag":78,"props":870,"children":871},{},[872],{"type":44,"value":873},"Debugging with error overlay",{"type":38,"tag":78,"props":875,"children":876},{},[877],{"type":44,"value":878},"Fixes for each cause",{"type":38,"tag":53,"props":880,"children":882},{"id":881},"suspense-boundaries",[883],{"type":44,"value":884},"Suspense Boundaries",{"type":38,"tag":47,"props":886,"children":887},{},[888,889,895],{"type":44,"value":63},{"type":38,"tag":65,"props":890,"children":892},{"href":891},".\u002Fsuspense-boundaries.md",[893],{"type":44,"value":894},"suspense-boundaries.md",{"type":44,"value":72},{"type":38,"tag":74,"props":897,"children":898},{},[899,915],{"type":38,"tag":78,"props":900,"children":901},{},[902,904,909,910],{"type":44,"value":903},"CSR bailout with ",{"type":38,"tag":169,"props":905,"children":907},{"className":906},[],[908],{"type":44,"value":329},{"type":44,"value":176},{"type":38,"tag":169,"props":911,"children":913},{"className":912},[],[914],{"type":44,"value":322},{"type":38,"tag":78,"props":916,"children":917},{},[918],{"type":44,"value":919},"Which hooks require Suspense boundaries",{"type":38,"tag":53,"props":921,"children":923},{"id":922},"parallel-intercepting-routes",[924],{"type":44,"value":925},"Parallel & Intercepting Routes",{"type":38,"tag":47,"props":927,"children":928},{},[929,930,936],{"type":44,"value":63},{"type":38,"tag":65,"props":931,"children":933},{"href":932},".\u002Fparallel-routes.md",[934],{"type":44,"value":935},"parallel-routes.md",{"type":44,"value":72},{"type":38,"tag":74,"props":938,"children":939},{},[940,960,971],{"type":38,"tag":78,"props":941,"children":942},{},[943,945,951,952,958],{"type":44,"value":944},"Modal patterns with ",{"type":38,"tag":169,"props":946,"children":948},{"className":947},[],[949],{"type":44,"value":950},"@slot",{"type":44,"value":176},{"type":38,"tag":169,"props":953,"children":955},{"className":954},[],[956],{"type":44,"value":957},"(.)",{"type":44,"value":959}," interceptors",{"type":38,"tag":78,"props":961,"children":962},{},[963,969],{"type":38,"tag":169,"props":964,"children":966},{"className":965},[],[967],{"type":44,"value":968},"default.tsx",{"type":44,"value":970}," for fallbacks",{"type":38,"tag":78,"props":972,"children":973},{},[974,976],{"type":44,"value":975},"Closing modals correctly with ",{"type":38,"tag":169,"props":977,"children":979},{"className":978},[],[980],{"type":44,"value":981},"router.back()",{"type":38,"tag":53,"props":983,"children":985},{"id":984},"self-hosting",[986],{"type":44,"value":987},"Self-Hosting",{"type":38,"tag":47,"props":989,"children":990},{},[991,992,998],{"type":44,"value":63},{"type":38,"tag":65,"props":993,"children":995},{"href":994},".\u002Fself-hosting.md",[996],{"type":44,"value":997},"self-hosting.md",{"type":44,"value":72},{"type":38,"tag":74,"props":1000,"children":1001},{},[1002,1013,1018],{"type":38,"tag":78,"props":1003,"children":1004},{},[1005,1011],{"type":38,"tag":169,"props":1006,"children":1008},{"className":1007},[],[1009],{"type":44,"value":1010},"output: 'standalone'",{"type":44,"value":1012}," for Docker",{"type":38,"tag":78,"props":1014,"children":1015},{},[1016],{"type":44,"value":1017},"Cache handlers for multi-instance ISR",{"type":38,"tag":78,"props":1019,"children":1020},{},[1021],{"type":44,"value":1022},"What works vs needs extra setup",{"type":38,"tag":53,"props":1024,"children":1026},{"id":1025},"debug-tricks",[1027],{"type":44,"value":1028},"Debug Tricks",{"type":38,"tag":47,"props":1030,"children":1031},{},[1032,1033,1039],{"type":44,"value":63},{"type":38,"tag":65,"props":1034,"children":1036},{"href":1035},".\u002Fdebug-tricks.md",[1037],{"type":44,"value":1038},"debug-tricks.md",{"type":44,"value":72},{"type":38,"tag":74,"props":1041,"children":1042},{},[1043,1048],{"type":38,"tag":78,"props":1044,"children":1045},{},[1046],{"type":44,"value":1047},"MCP endpoint for AI-assisted debugging",{"type":38,"tag":78,"props":1049,"children":1050},{},[1051,1053],{"type":44,"value":1052},"Rebuild specific routes with ",{"type":38,"tag":169,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":44,"value":1058},"--debug-build-paths",{"items":1060,"total":1171},[1061,1078,1096,1113,1128,1145,1160],{"slug":1062,"name":1062,"fn":1063,"description":1064,"org":1065,"tags":1066,"stars":20,"repoUrl":21,"updatedAt":1077},"ai-gateway","configure and manage Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1067,1070,1073,1076],{"name":1068,"slug":1069,"type":15},"AI Infrastructure","ai-infrastructure",{"name":1071,"slug":1072,"type":15},"Cost Optimization","cost-optimization",{"name":1074,"slug":1075,"type":15},"LLM","llm",{"name":9,"slug":8,"type":15},"2026-04-06T18:56:06.57787",{"slug":1079,"name":1079,"fn":1080,"description":1081,"org":1082,"tags":1083,"stars":20,"repoUrl":21,"updatedAt":1095},"auth","integrate authentication in Next.js apps","Authentication integration guidance — Clerk (native Vercel Marketplace), Descope, and Auth0 setup for Next.js applications. Covers middleware auth patterns, sign-in\u002Fsign-up flows, and Marketplace provisioning. Use when implementing user authentication.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1084,1087,1090,1091,1094],{"name":1085,"slug":1086,"type":15},"Auth0","auth0",{"name":1088,"slug":1089,"type":15},"Authentication","authentication",{"name":18,"slug":19,"type":15},{"name":1092,"slug":1093,"type":15},"Security","security",{"name":9,"slug":8,"type":15},"2026-04-06T18:56:17.050565",{"slug":1097,"name":1097,"fn":1098,"description":1099,"org":1100,"tags":1101,"stars":20,"repoUrl":21,"updatedAt":1112},"bootstrap","bootstrap Vercel-linked repositories","Project bootstrapping orchestrator for repos that depend on Vercel-linked resources (databases, auth, and managed integrations). Use when setting up or repairing a repository so linking, environment provisioning, env pulls, and first-run db\u002Fdev commands happen in the correct safe order.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1102,1105,1108,1111],{"name":1103,"slug":1104,"type":15},"Configuration","configuration",{"name":1106,"slug":1107,"type":15},"Deployment","deployment",{"name":1109,"slug":1110,"type":15},"Local Development","local-development",{"name":9,"slug":8,"type":15},"2026-04-06T18:56:18.297868",{"slug":1114,"name":1114,"fn":1115,"description":1116,"org":1117,"tags":1118,"stars":20,"repoUrl":21,"updatedAt":1127},"cdn-caching","debug Vercel CDN caching behavior","Debug Vercel CDN caching — cache hit rate, stale content, revalidation behavior, ISR + PPR, per-request cache reasons (cacheReason) and PPR state (ppr_state), and costs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1119,1122,1125,1126],{"name":1120,"slug":1121,"type":15},"Caching","caching",{"name":1123,"slug":1124,"type":15},"Observability","observability",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-07-30T05:31:34.628944",{"slug":1129,"name":1129,"fn":1130,"description":1131,"org":1132,"tags":1133,"stars":20,"repoUrl":21,"updatedAt":1144},"chat-sdk","build multi-platform chatbots with Vercel","Vercel Chat SDK expert guidance. Use when building multi-platform chat bots — Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, Linear — with a single codebase. Covers the Chat class, adapters, threads, messages, cards, modals, streaming, state management, and webhook setup.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1134,1137,1140,1143],{"name":1135,"slug":1136,"type":15},"Agents","agents",{"name":1138,"slug":1139,"type":15},"Messaging","messaging",{"name":1141,"slug":1142,"type":15},"SDK","sdk",{"name":9,"slug":8,"type":15},"2026-04-06T18:56:26.921901",{"slug":1146,"name":1146,"fn":1147,"description":1148,"org":1149,"tags":1150,"stars":20,"repoUrl":21,"updatedAt":1159},"deployments-cicd","manage Vercel deployments and CI\u002FCD","Vercel deployment and CI\u002FCD expert guidance. Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1151,1154,1155,1158],{"name":1152,"slug":1153,"type":15},"CI\u002FCD","ci-cd",{"name":1106,"slug":1107,"type":15},{"name":1156,"slug":1157,"type":15},"Operations","operations",{"name":9,"slug":8,"type":15},"2026-04-06T18:56:22.054263",{"slug":1161,"name":1161,"fn":1162,"description":1163,"org":1164,"tags":1165,"stars":20,"repoUrl":21,"updatedAt":1170},"env-vars","manage Vercel environment variables","Vercel environment variable expert guidance. Use when working with .env files, vercel env commands, OIDC tokens, or managing environment-specific configuration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1166,1167,1168,1169],{"name":1103,"slug":1104,"type":15},{"name":1156,"slug":1157,"type":15},{"name":1092,"slug":1093,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:56:28.150777",29,{"items":1173,"total":1336},[1174,1192,1204,1221,1232,1245,1261,1275,1287,1306,1316,1326],{"slug":1175,"name":1175,"fn":1176,"description":1177,"org":1178,"tags":1179,"stars":1189,"repoUrl":1190,"updatedAt":1191},"next-cache-components-adoption","enable and migrate to Next.js Cache Components","Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender \u002F instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1180,1181,1184,1187,1188],{"name":1120,"slug":1121,"type":15},{"name":1182,"slug":1183,"type":15},"Frontend","frontend",{"name":1185,"slug":1186,"type":15},"Migration","migration",{"name":18,"slug":19,"type":15},{"name":9,"slug":8,"type":15},141208,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fnext.js","2026-07-24T05:38:30.118542",{"slug":1193,"name":1193,"fn":1194,"description":1195,"org":1196,"tags":1197,"stars":1189,"repoUrl":1190,"updatedAt":1203},"next-cache-components-optimizer","optimize Next.js cache components","Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components \u002F PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next\u002Fplaywright instant() e2e and work it to green, one verified route at a time; the shipped test then guards against regression. Use when asked to make a route's navigation instant (its static shell commits immediately), fix a route whose static shell isn't prerendered\u002Fserved\u002Fprefetched, grow a route's static shell or fix its slow first paint, diagnose which Suspense boundary keeps a route out of its static shell, or write the instant() e2e guard for one. Requires Next.js 16.3+ with cacheComponents; directs an upgrade if older.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1198,1199,1200,1201,1202],{"name":1120,"slug":1121,"type":15},{"name":1182,"slug":1183,"type":15},{"name":18,"slug":19,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-07-30T05:31:10.674078",{"slug":1205,"name":1205,"fn":1206,"description":1207,"org":1208,"tags":1209,"stars":1189,"repoUrl":1190,"updatedAt":1220},"next-dev-loop","verify Next.js runtime behavior","Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines \u002F_next\u002Fmcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1210,1213,1214,1215,1216,1217],{"name":1211,"slug":1212,"type":15},"Debugging","debugging",{"name":1182,"slug":1183,"type":15},{"name":1109,"slug":1110,"type":15},{"name":18,"slug":19,"type":15},{"name":9,"slug":8,"type":15},{"name":1218,"slug":1219,"type":15},"Web Development","web-development","2026-05-22T06:45:28.627735",{"slug":1222,"name":1222,"fn":1223,"description":1224,"org":1225,"tags":1226,"stars":1189,"repoUrl":1190,"updatedAt":1231},"next-partial-prefetching-adoption","adopt Partial Prefetching in Next.js apps","Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the `partialPrefetching` flag, opt routes in with `export const prefetch = 'partial'`, audit `\u003CLink prefetch={true}>` calls, or resolve the link-prefetch-partial and instant-shell-url-data insights.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1227,1228,1229,1230],{"name":1182,"slug":1183,"type":15},{"name":18,"slug":19,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-07-30T05:31:11.591864",{"slug":1233,"name":1233,"fn":1234,"description":1235,"org":1236,"tags":1237,"stars":1242,"repoUrl":1243,"updatedAt":1244},"turborepo","manage monorepos with Turborepo","Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines,\ndependsOn, caching, remote cache, the \"turbo\" CLI, --filter, --affected, CI optimization, environment\nvariables, internal packages, monorepo structure\u002Fbest practices, and boundaries.\n\nUse when user: configures tasks\u002Fworkflows\u002Fpipelines, creates packages, sets up\nmonorepo, shares code between apps, runs changed\u002Faffected packages, debugs cache,\nor has apps\u002Fpackages directories.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1238,1239,1240],{"name":1152,"slug":1153,"type":15},{"name":13,"slug":14,"type":15},{"name":1241,"slug":1233,"type":15},"Turborepo",30809,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fturborepo","2026-07-30T05:32:14.920116",{"slug":1246,"name":1246,"fn":1247,"description":1248,"org":1249,"tags":1250,"stars":1258,"repoUrl":1259,"updatedAt":1260},"add-function-examples","add AI function examples for testing","Guide for adding new AI function examples, for testing specific features against the actual provider APIs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1251,1254,1257],{"name":1252,"slug":1253,"type":15},"AI SDK","ai-sdk",{"name":1255,"slug":1256,"type":15},"Testing","testing",{"name":9,"slug":8,"type":15},25670,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fai","2026-04-06T18:55:51.318866",{"slug":1262,"name":1262,"fn":1263,"description":1264,"org":1265,"tags":1266,"stars":1258,"repoUrl":1259,"updatedAt":1274},"add-harness-package","add AI SDK harness packages","Guide for adding new AI SDK harness packages. Use when creating a new @ai-sdk\u002Fharness-\u003Cname> package that adapts a coding-agent runtime to HarnessV1.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1267,1268,1269,1272,1273],{"name":1135,"slug":1136,"type":15},{"name":1252,"slug":1253,"type":15},{"name":1270,"slug":1271,"type":15},"Harness","harness",{"name":1141,"slug":1142,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:29:19.858737",{"slug":1276,"name":1276,"fn":1277,"description":1278,"org":1279,"tags":1280,"stars":1258,"repoUrl":1259,"updatedAt":1286},"add-provider-package","add new provider packages to AI SDK","Guide for adding new AI provider packages to the AI SDK. Use when creating a new @ai-sdk\u002F\u003Cprovider> package to integrate an AI service into the SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1281,1282,1285],{"name":1252,"slug":1253,"type":15},{"name":1283,"slug":1284,"type":15},"API Development","api-development",{"name":9,"slug":8,"type":15},"2026-04-06T18:55:47.45549",{"slug":1288,"name":1288,"fn":1289,"description":1290,"org":1291,"tags":1292,"stars":1258,"repoUrl":1259,"updatedAt":1305},"adr-skill","create and maintain architecture decision records","Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept\u002Freject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1293,1296,1299,1302],{"name":1294,"slug":1295,"type":15},"ADR","adr",{"name":1297,"slug":1298,"type":15},"Architecture","architecture",{"name":1300,"slug":1301,"type":15},"Documentation","documentation",{"name":1303,"slug":1304,"type":15},"Engineering","engineering","2026-04-06T18:55:50.043694",{"slug":1253,"name":1253,"fn":1307,"description":1308,"org":1309,"tags":1310,"stars":1258,"repoUrl":1259,"updatedAt":1315},"build AI features with Vercel AI SDK","Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: \"AI SDK\", \"Vercel AI SDK\", \"generateText\", \"streamText\", \"add AI to my app\", \"build an agent\", \"tool calling\", \"structured output\", \"useChat\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1311,1312,1313,1314],{"name":1135,"slug":1136,"type":15},{"name":1252,"slug":1253,"type":15},{"name":1074,"slug":1075,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:55:48.739463",{"slug":1317,"name":1317,"fn":1318,"description":1319,"org":1320,"tags":1321,"stars":1258,"repoUrl":1259,"updatedAt":1325},"capture-api-response-test-fixture","capture API response test fixtures","Capture API response test fixture.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1322,1323,1324],{"name":1283,"slug":1284,"type":15},{"name":1255,"slug":1256,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:55:56.374433",{"slug":1327,"name":1327,"fn":1328,"description":1329,"org":1330,"tags":1331,"stars":1258,"repoUrl":1259,"updatedAt":1335},"develop-ai-functions-example","develop AI SDK function examples","Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples\u002Fai-functions\u002Fsrc to validate provider support, demonstrate features, or create test fixtures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1332,1333,1334],{"name":1252,"slug":1253,"type":15},{"name":1255,"slug":1256,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:55:55.088956",68]