Skip to main content
subagent CX Codex

nextjs-expert · 0xfurai — Claude Code subagent: what it does, install

nextjs-expert is a Claude Code subagent for Next.js work across SSR, SSG, API routes, and React apps. It joins tasks involving routing, data loading, and app checks.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/nextjs-expert.md
Open on GitHub

What nextjs-expert does

nextjs-expert assists with Next.js applications that use server rendering, static generation, and API routes. It covers routing, data fetching, the Image component, React hooks, TypeScript, CMS connections, and custom app configuration.

Its workflow includes code splitting, lazy loading, authentication, environment variables, and Vercel deployment setup. It checks page rendering, API JSON responses, TypeScript types, hydration errors, asset caching, loading states, and accessibility.

For Claude Code, place the subagent file at .claude/agents/nextjs-expert.md. The declared model is claude-sonnet-4-20250514.

What it helps with

  • design SSR and SSG for Next.js pages
  • configure API routes that return JSON
  • trace hydration errors in a React app
  • review routing, TypeScript types, and accessibility
  • prepare a Next.js deployment with Vercel

Example prompts for the agent

  • Review this Next.js app and suggest an SSR and SSG structure.
  • Inspect the API routes and find the source of the hydration error.
  • Set up data loading, routing, and image optimization for this project.

How to install nextjs-expert

Manually: put the files in place

.claude/agents/nextjs-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about nextjs-expert

How do I install nextjs-expert in Claude Code?

Place the subagent file at .claude/agents/nextjs-expert.md.

What does nextjs-expert do?

It supports Next.js and React work involving SSR, SSG, API routes, routing, TypeScript, authentication, image optimization, and hydration checks.

What does nextjs-expert check in an application?

It checks page rendering, API JSON responses, TypeScript types, static asset caching, accessibility, and loading-state handling.

Source text

nextjs-expert.md · MIT
---
name: nextjs-expert
description: Expert in Next.js development, specializing in serverless architecture, static site generation, and optimized React apps.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Mastery of Next.js server-side rendering (SSR) and static site generation (SSG)
- Implementation of API routes with Next.js
- Integration with popular CMS and headless CMS options
- Configuration of custom document and app in Next.js
- Next.js Image Optimization techniques
- Use of React hooks and context in a Next.js environment
- Managing static and dynamic routing in Next.js
- Employing code splitting and lazy loading for performance
- Authentication and authorization strategies within Next.js
- Leveraging TypeScript for Next.js projects

## Approach

- Utilize `getStaticProps` and `getServerSideProps` for optimal data fetching
- Configure Next.js for both CDN and serverless deployments
- Favor static generation with incremental static regeneration where possible
- Use API routes for serverless function scalability
- Integrate third-party services through environment variables
- Optimize build performance with webpack and custom Babel configurations
- Implement custom server logic without ejecting from Next.js
- Apply industry best practices for SEO in Next.js apps
- Utilize Vercel's deployment and preview features for dev workflows
- Structure project for scalability and maintainability

## Quality Checklist

- Ensure all pages render correctly with SSR and SSG
- Verify API routes return expected JSON responses
- Review Image component usage for optimized loading
- Check custom client and server configurations align
- Validate TypeScript types across the codebase
- Ensure routing is intuitive and can handle edge cases
- Confirm static assets are correctly cached
- Test performance and loading times meet standards
- Debug and fix any hydration errors
- Conduct thorough accessibility audits

## Output

- High-performance Next.js applications tailored to static and dynamic content needs
- APIs seamlessly integrated with external and internal data sources
- Consistent UI/UX with React and Next.js best practices
- Modular, maintainable code following Next.js conventions
- Effective error handling and loading states implemented
- CI/CD pipelines configured for automatic deployments with Vercel
- Documented code with inline comments and README guides
- Optimized media assets using Next.js built-in tools
- Responsive design with server-side responsive data
- Secure Next.js apps with environments for different stages

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Frontend and UI →

nextjs-expert by other authors comes first.

nextjs-expert carlrannaberg nextjs-expert diagnoses Next.js 13–15 hydration bugs, resolves App Router caching conflicts, and fixes Server Component boundaries. CX Codex ★ 763repo stars nextjs-typescript-tailwindcss-supabase Mindrally nextjs-typescript-tailwindcss-supabase — a skill that steers your agent toward Next.js 14, TypeScript, TailwindCSS and Supabase: server components, error handling, readable code. CX Codex +1 1,400installs nextjs-developer https://github.com/Jeffallan nextjs-developer configures Next.js 14+ application architecture using App Router, React Server Components, and Server Actions. Useful when setting up SSR streaming, SEO metadata, and Vercel deployments. CX Codex +1 6,200installs nextjs-vercel-typescript-cursorrules-prompt-file PatrickJS nextjs-vercel-typescript-cursorrules-prompt-file — a Cursor rule that sets code style and file structure for Next.js projects with TypeScript, Vercel middleware and a KV database. CX Codex +1 ★ 41,178repo stars nextjs Claude Skills Maintainers Skill for Next.js 16 and React 19.2 with App Router, Server Components, Server Actions, and caching patterns. Handles migration from version 15, async params errors, and Partial Prerendering setup. CX Codex +1 299installs material-ui-nextjs mui material-ui-nextjs — a skill for wiring Material UI into Next.js: SSR, Emotion cache, next/font, CSS layers, Link, and useSearchParams. Use it when setting up or debugging MUI in a Next.js app. CX Codex +1 776installs vinext-vite-nextjs reason-machines vinext-vite-nextjs guides your AI assistant through running Next.js codebases on Vite and deploying them to Cloudflare Workers. CX Codex +1 1,400installs

From the same set137

The whole set →
lua-expert lua-expert writes and optimizes idiomatic Lua code, configures metatables, and handles cooperative multitasking with coroutines. CX Codex ★ 1,029repo stars puppeteer-expert The puppeteer-expert subagent builds Puppeteer workflows for headless browsing, scraping, and automated checks. Use it when pages load content dynamically or require browser interactions. CX Codex ★ 1,029repo stars auth0-expert auth0-expert — a Claude subagent for Auth0 work: dashboard configuration, OAuth2.0 and OpenID Connect flows, social login, MFA, SSO, Rules and Hooks. CX Codex ★ 1,029repo stars tailwind-expert The tailwind-expert subagent for Claude Code guides responsive Tailwind CSS styling, theme setup, and PurgeCSS cleanup for web projects. CX Codex ★ 1,029repo stars mongodb-expert mongodb-expert — a Claude subagent for MongoDB work: schema design, indexes, aggregation pipelines, replication, backups and migrations. CX Codex ★ 1,029repo stars rabbitmq-expert rabbitmq-expert is a Claude Code subagent focused on RabbitMQ architecture, queue tuning, and high-availability clustering. CX Codex ★ 1,029repo stars dynamodb-expert The dynamodb-expert subagent for Claude Code helps design DynamoDB schemas, choose keys and indexes, and review queries and capacity settings when designing or checking a database. CX Codex ★ 1,029repo stars grpc-expert grpc-expert — a Claude subagent for gRPC work: streaming, protobuf, channel setup, load balancing and tracing. Useful when calls fail with vague status codes. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open