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
.claude/agents/nextjs-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/nextjs-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/nextjs-expert.mdCursor also reads .claude/agents/
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.