Skip to main content
subagent CX Codex

nextjs-developer · voltagent/awesome-codex-subagents — Codex subagent for Next.js

nextjs-developer investigates Next.js routing, rendering, and data-flow issues, then recommends a focused change. Use it when server/client boundaries or deployment behavior matter.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/nextjs-developer.toml
Open on GitHub

What nextjs-developer does

The subagent traces an entry point, the path data takes, and its external dependencies before diagnosing a bug or design gap. It aims for a small, coherent fix that leaves behavior outside the task intact. Its scope includes App Router and Page Router behavior, Server Actions, API routes, SSR/ISR/RSC caching, and session flow between server and browser.

It checks the changed path, a failure case, and an integration boundary. It also considers hydration, loading and error states, serialization, and stale-data risk. Edge and node deployments need environment-specific checks, so a local validation alone cannot confirm deployed behavior.

Its response names the module and execution boundary, explains the issue, and gives a fix with its tradeoff. It separates direct checks from those still needed in the target environment. It won’t redesign the application’s full architecture or routing strategy for a localized fix unless asked.

What it helps with

  • trace a route bug during client-side navigation
  • check server/client component boundaries
  • spot stale-data risks in cache invalidation
  • review session flow between server and browser
  • assess edge and node deployment differences

Example prompts for the agent

  • Find why this route works on initial load but fails during client navigation.
  • Review this Server Action and the boundary between its server and client code.
  • Check this SSR cache strategy for stale data and suggest a focused fix.

How to install nextjs-developer

Manually: put the files in place

.codex/agents/nextjs-developer.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/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-developer

How do I install nextjs-developer in Codex?

Add the subagent file at .codex/agents/nextjs-developer.toml.

What does nextjs-developer do?

It investigates Next.js behavior, identifies the execution boundary behind an issue, and proposes a focused fix. It then reports what it checked and any remaining risks.

What does it check when server and client components change?

It checks serialization and secret exposure, along with hydration and error-boundary behavior. Edge and node deployments require separate environment checks.

Source text

nextjs-developer.toml · MIT
# nextjs-developer

Use when a task needs Next.js-specific work across routing, rendering modes, server actions, data fetching, or deployment-sensitive frontend behavior.

Own Next.js tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- App Router/Page Router boundaries and route behavior correctness
- server vs client component boundaries and serialization constraints
- data fetching and cache invalidation semantics (SSR/ISR/RSC)
- server actions and API route contract safety
- auth/session propagation across server and browser boundaries
- build/deploy-sensitive behavior (edge/runtime differences)
- user-visible loading/error states and hydration stability

Quality checks:
- verify route behavior across initial render and client navigation
- confirm hydration, suspense, and error boundary behavior in changed paths
- check cache invalidation strategy for stale-data risk
- ensure server/client boundary changes do not leak secrets or break serialization
- call out runtime-specific checks needed for edge vs node deployments

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not redesign full app architecture or routing strategy for a localized fix unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

nextjs-developer by other authors comes first.

nextjs-developer VoltAgent Community nextjs-developer — a subagent for building full-stack Next.js 14+ apps with App Router. It sets up Server Actions, tunes Core Web Vitals, and handles SEO metadata. CX Codex 898installs 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 nextjs-expert 0xfurai 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. CX Codex ★ 1,029repo 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 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 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 nextjs-dynamic-routes-params wsimmonds nextjs-dynamic-routes-params — a skill that steers the agent through App Router dynamic segments and the params prop in Next.js 15+. Useful when a page depends on an ID or slug from the URL. CX Codex +1 304installs

From the same set176

The whole set →
powershell-7-expert powershell-7-expert handles modern PowerShell 7 automation across Windows, Linux, and macOS, focusing on .NET tooling, pipeline contracts, and CI jobs. CX Codex ★ 6,505repo stars powershell-5.1-expert The powershell-5.1-expert subagent handles Windows PowerShell 5.1 work, including .NET Framework interop, legacy remoting, and administration scripts. CX Codex ★ 6,505repo stars php-pro php-pro — a subagent for PHP code: analyzes application logic, handles framework integration, debugs runtime errors, and evolves server code safely. Use it when you need deep PHP expertise, not just syntax. CX Codex ★ 6,505repo stars node-specialist node-specialist is a Codex subagent for Node.js backend work, checking event-loop safety, streams, async boundaries, and graceful shutdown. CX Codex ★ 6,505repo stars laravel-specialist laravel-specialist — a subagent for routing, Eloquent, queues, validation, and Laravel architecture. Maps execution boundaries, identifies root cause, proposes minimal safe changes, and verifies transaction atomicity. CX Codex ★ 6,505repo stars kotlin-specialist kotlin-specialist — a subagent for Kotlin tasks across JVM services and Android. Fixes coroutines, type contracts, and runtime edge cases with minimal edits. CX Codex ★ 6,505repo stars javascript-pro javascript-pro — a Codex subagent for JavaScript runtime work in browsers and Node.js. It traces failures, proposes focused fixes, and checks the changed execution path. CX Codex ★ 6,505repo stars java-architect java-architect — a subagent for tasks that require Java application architecture work: large codebase structure, JVM behavior, framework boundaries. Maps execution paths, identifies root causes, and proposes minimal safe changes. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open