Unverified Commit f0582ebd authored by Jude Gao's avatar Jude Gao Committed by GitHub

Remove embedded Claude Code plugin marketplace (#94877)

parent b216be9c
{
"name": "nextjs",
"owner": {
"name": "Vercel",
"url": "https://vercel.com"
},
"plugins": [
{
"name": "cache-components",
"source": "./plugins/cache-components",
"description": "Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). Proactively activates in projects with cacheComponents enabled.",
"version": "1.0.0",
"author": {
"name": "Next.js Team"
}
}
]
}
# Next.js Claude Code Plugins
This directory contains Claude Code plugins for Next.js development.
## Using the Next.js Plugin Marketplace
The Next.js repository serves as a Claude Code plugin marketplace. Team members and contributors can install plugins directly from this repo.
### Quick Start
```bash
# Add the Next.js marketplace
/plugin marketplace add vercel/next.js
# List available plugins
/plugin list
# Install a plugin
/plugin install cache-components@nextjs
```
### Available Plugins
| Plugin | Description |
|--------|-------------|
| `cache-components` | Expert guidance for Cache Components and PPR |
## For Team Members
To auto-enable plugins for everyone working in a Next.js project, add to `.claude/settings.json`:
```json
{
"extraKnownMarketplaces": {
"nextjs": {
"source": {
"source": "github",
"repo": "vercel/next.js"
}
}
},
"enabledPlugins": {
"cache-components@nextjs": true
}
}
```
## Creating New Plugins
To add a new plugin to the marketplace:
### 1. Create Plugin Directory
```bash
mkdir -p .claude-plugin/plugins/my-plugin/.claude-plugin
mkdir -p .claude-plugin/plugins/my-plugin/skills/my-skill
```
### 2. Create Plugin Manifest
**File**: `.claude-plugin/plugins/my-plugin/.claude-plugin/plugin.json`
```json
{
"name": "my-plugin",
"version": "1.0.0",
"description": "What the plugin does",
"author": {
"name": "Next.js Team"
}
}
```
### 3. Create Skill
**File**: `.claude-plugin/plugins/my-plugin/skills/my-skill/SKILL.md`
```yaml
---
name: my-skill
description: When to use this skill
---
# My Skill
Instructions for Claude...
```
### 4. Register in Marketplace
Add to `.claude-plugin/marketplace.json`:
```json
{
"plugins": [
{
"name": "my-plugin",
"source": "./plugins/my-plugin",
"description": "What it does"
}
]
}
```
### 5. Test Locally
```bash
claude --plugin-dir .claude-plugin/plugins/my-plugin
```
## Plugin Structure
```
.claude-plugin/
├── marketplace.json ← Marketplace catalog
└── plugins/
├── README.md ← This file
└── cache-components/
├── .claude-plugin/
│ └── plugin.json ← Plugin manifest
├── skills/
│ └── cache-components/
│ ├── SKILL.md ← Main skill file
│ ├── REFERENCE.md ← API reference
│ ├── PATTERNS.md ← Usage patterns
│ └── TROUBLESHOOTING.md ← Debugging guide
└── README.md ← Plugin documentation
```
{
"name": "cache-components",
"version": "1.0.0",
"description": "Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). Proactively activates in projects with cacheComponents: true, providing patterns for 'use cache' directive, cacheLife(), cacheTag(), cache invalidation, and parameter permutation rendering.",
"author": {
"name": "Next.js Team",
"url": "https://nextjs.org"
},
"homepage": "https://nextjs.org/docs/app/building-your-application/caching",
"repository": "https://github.com/vercel/next.js",
"license": "MIT",
"keywords": [
"nextjs",
"cache",
"ppr",
"partial-prerendering",
"react-server-components",
"use-cache"
]
}
# Cache Components Plugin for Claude Code
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR).
## Features
This plugin provides a comprehensive skill that:
- **Proactively activates** in projects with `cacheComponents: true`
- Teaches the `'use cache'` directive, `cacheLife()`, `cacheTag()`, and invalidation APIs
- Explains **parameter permutation rendering** and subshell generation
- Covers migration from deprecated `revalidate`/`dynamic` segment configs
- Provides build-time error solutions and debugging guidance
## Installation
### Step 1: Add the Next.js Marketplace
```
/plugin marketplace add vercel/next.js
```
### Step 2: Install the Plugin
```
/plugin install cache-components@nextjs
```
Or install via CLI:
```bash
claude plugin install cache-components@nextjs
```
### Step 3 (Optional): Enable for Your Team
Add to your project's `.claude/settings.json` to auto-enable for all team members:
```json
{
"enabledPlugins": {
"cache-components@nextjs": true
}
}
```
## What's Included
| File | Description |
|------|-------------|
| `SKILL.md` | Core concepts, APIs, and proactive application guidelines |
| `REFERENCE.md` | Complete API reference, generateStaticParams, deprecated configs |
| `PATTERNS.md` | 12 production patterns including subshell composition |
| `TROUBLESHOOTING.md` | Build errors, debugging techniques, common issues |
## Usage
Once installed, the skill automatically activates when:
1. You're working in a Next.js project with `cacheComponents: true`
2. You ask about caching, PPR, or the `'use cache'` directive
3. You're writing React Server Components or Server Actions
### Example Triggers
- "How do I cache this data fetching function?"
- "What's the difference between updateTag and revalidateTag?"
- "I'm getting a build error about uncached data outside Suspense"
- "Help me set up generateStaticParams for my product pages"
## Key Concepts Covered
### Parameter Permutation Rendering
When you provide `generateStaticParams`, Next.js renders ALL permutations:
```
generateStaticParams returns:
[{ category: 'jackets', slug: 'bomber' }]
Next.js renders:
/products/jackets/bomber ← Complete page
/products/jackets/[slug] ← Category subshell (reusable!)
/products/[category]/[slug] ← Fallback shell
```
### Deprecated Segment Configs
| Old (Deprecated) | New (Cache Components) |
|------------------|------------------------|
| `export const revalidate = 3600` | `cacheLife('hours')` inside `'use cache'` |
| `export const dynamic = 'force-static'` | Use `'use cache'` + Suspense |
## Contributing
This plugin lives in the Next.js repository at `.claude-plugin/plugins/cache-components/`.
To contribute improvements:
1. Edit files in `.claude-plugin/plugins/cache-components/skills/cache-components/`
2. Test locally with `claude --plugin-dir .claude-plugin/plugins/cache-components`
3. Submit a PR to the Next.js repository
## Version History
### 1.0.0
- Initial release
- Covers `'use cache'`, `cacheLife()`, `cacheTag()`, `updateTag()`, `revalidateTag()`
- Parameter permutation rendering and subshell generation
- Migration guide from deprecated segment configs
- Build-time feedback and troubleshooting
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment