Skip to main content
plugin

nextjs-expert — Claude Code plugin: what it does, how to install

The nextjs-expert plugin for Claude Code and Cursor provides five skills and three slash commands for the Next.js App Router, supporting page and API development in Next.js 15.

MIT ★ 3,785 updated 2026-10-25

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add davepoon/buildwithclaude
/plugin install nextjs-expert@buildwithclaude
Open on GitHub

What nextjs-expert does

The plugin ships five skills for the Next.js App Router: app-router, server-components, route-handlers, server-actions and auth-patterns. Between them they cover file conventions such as page.tsx and layout.tsx, parallel and intercepting routes, 'use client' boundaries, HTTP method handlers with streaming, Zod-validated forms, and middleware route protection.

Each skill has a SKILL.md plus references and examples folders, so detail gets loaded only when a task calls for it. Three namespaced commands sit on top. /nextjs-expert:scaffold generates pages, components and API routes, /nextjs-expert:add-auth wires up NextAuth.js with providers and middleware, and /nextjs-expert:optimize reviews component boundaries, data fetching and caching.

The patterns target Next.js 15. The auth command sets up NextAuth.js specifically, so any other auth library is yours to integrate by hand.

What it helps with

  • generate a blog post page with a dynamic app/blog/[slug]/page.tsx route
  • decide which components should run on the server and which on the client
  • write a route handler that streams its response
  • handle a form submission in a Server Action and validate it with Zod
  • protect pages with middleware and split access by user role

Example prompts for the agent

  • Create a blog post page with dynamic routing, a loading state and an error state
  • Add GitHub and Google sign-in to my app with /nextjs-expert:add-auth
  • Run /nextjs-expert:optimize and check my server and client component boundaries

How to install nextjs-expert

Plugin marketplace

/plugin marketplace add davepoon/buildwithclaude
/plugin install nextjs-expert@buildwithclaude

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about nextjs-expert

How do I install nextjs-expert in Claude Code?

Run two commands in order: /plugin marketplace add davepoon/buildwithclaude, then /plugin install nextjs-expert@buildwithclaude.

What does nextjs-expert do?

It gives Claude Code five skills on the Next.js App Router and three slash commands. The skills guide routing, components, handlers and auth; the commands scaffold code, add sign-in and review performance.

Which slash commands does nextjs-expert include?

/nextjs-expert:scaffold creates pages, components and API routes, /nextjs-expert:add-auth sets up NextAuth.js, and /nextjs-expert:optimize analyzes the app and returns recommendations.

Source text

nextjs-expert · MIT
# Next.js Expert Plugin

A comprehensive Claude Code plugin providing Next.js development expertise with skills for App Router, Server Components, Route Handlers, Server Actions, and authentication patterns.

## Features

- **5 Skills** covering core Next.js App Router concepts
- **3 Commands** for common development tasks
- **Progressive disclosure** with references and examples
- **Next.js 15** compatible patterns

## Installation

Add to your Claude Code settings:

```json
{
  "plugins": [
    "https://github.com/davepoon/buildwithclaude/tree/main/plugins/nextjs-expert"
  ]
}
```

## Skills

### app-router

File-based routing, layouts, metadata, and route organization for Next.js App Router.

**Topics covered:**
- File conventions (page.tsx, layout.tsx, loading.tsx, error.tsx)
- Dynamic routes and catch-all segments
- Parallel routes and intercepting routes
- Route groups and organization

### server-components

React Server Components patterns and when to use server vs client components.

**Topics covered:**
- Server vs Client component decision guide
- 'use client' boundaries
- Composition patterns
- Data fetching in server components

### route-handlers

API route handlers in the app directory.

**Topics covered:**
- HTTP method handlers (GET, POST, PUT, PATCH, DELETE)
- Request/response handling
- Streaming responses
- CORS and authentication

### server-actions

Server Actions for form handling and mutations.

**Topics covered:**
- 'use server' directive
- Form handling with useFormState
- Validation with Zod
- Revalidation patterns

### auth-patterns

Authentication patterns for Next.js applications.

**Topics covered:**
- NextAuth.js v5 setup
- Middleware-based route protection
- Session management
- Role-based access control

## Commands

### /nextjs-expert:scaffold

Scaffold Next.js components following best practices.

```
/nextjs-expert:scaffold
```

Scaffolds pages, components, API routes, and more following App Router conventions.

### /nextjs-expert:add-auth

Add authentication to a Next.js application.

```
/nextjs-expert:add-auth
```

Sets up NextAuth.js with providers, middleware, and protected routes.

### /nextjs-expert:optimize

Analyze and optimize Next.js application performance.

```
/nextjs-expert:optimize
```

Reviews component boundaries, data fetching, caching, and provides recommendations.

## Directory Structure

```
nextjs-expert/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── app-router/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   │   ├── routing-conventions.md
│   │   │   ├── layouts-templates.md
│   │   │   └── loading-error-states.md
│   │   └── examples/
│   │       ├── dynamic-routes.md
│   │       └── parallel-routes.md
│   ├── server-components/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   │   ├── server-vs-client.md
│   │   │   └── composition-patterns.md
│   │   └── examples/
│   │       └── data-fetching-patterns.md
│   ├── route-handlers/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   │   ├── http-methods.md
│   │   │   └── streaming-responses.md
│   │   └── examples/
│   │       └── crud-api.md
│   ├── server-actions/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   │   ├── form-handling.md
│   │   │   └── revalidation.md
│   │   └── examples/
│   │       └── mutation-patterns.md
│   └── auth-patterns/
│       ├── SKILL.md
│       ├── references/
│       │   ├── middleware-auth.md
│       │   └── session-management.md
│       └── examples/
│           └── nextauth-setup.md
├── commands/
│   ├── scaffold.md
│   ├── add-auth.md
│   └── optimize.md
└── README.md
```

## Usage Examples

### Building a new page

Ask Claude:
> "Create a blog post page with dynamic routing"

Claude will use the `app-router` and `server-components` skills to generate:
- `app/blog/[slug]/page.tsx` with proper async params
- Loading and error states
- Metadata generation

### Adding authentication

Ask Claude:
> "Add GitHub and Google authentication to my app"

Or use the command:
> "/nextjs-expert:add-auth"

Claude will use the `auth-patterns` skill to set up:
- NextAuth.js configuration
- Middleware protection
- Login/logout components

### Optimizing performance

Ask Claude:
> "Review my app for performance issues"

Or use the command:
> "/nextjs-expert:optimize"

Claude will analyze:
- Client/server component boundaries
- Data fetching patterns
- Caching strategies
- Bundle size

## Contributing

Contributions welcome! Please follow the existing skill structure and include:
- SKILL.md with frontmatter and core content
- References for detailed documentation
- Examples with working code patterns

## License

MIT

© BuildWithClaude Community · MIT · davepoon/buildwithclaude

Similar plugins

All plugins for Frontend and UI →

From the same set235

The whole set →

Project sponsors

Companies that keep this analytics open