무료GitHub에 공개

opennext-cloudflare

Deploy Next.js to Cloudflare Workers using OpenNext adapter

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio

연동 도구Cloudflare

설치 방법 보기

포함된 파일(1)

SKILL.md2.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

OpenNext Cloudflare Skill

Deploy Next.js applications to Cloudflare Workers using the @opennextjs/cloudflare adapter.

When to use this skill

Deploying to Cloudflare Workers
Troubleshooting Cloudflare deployment issues
Configuring Cloudflare-specific features (KV, R2, D1)
Setting up CI/CD for Cloudflare

Current setup

Adapter: @opennextjs/cloudflare v1.19.11
Next.js: v16.2.9 (--dangerouslyUseUnsupportedNextVersion)
Worker name: namias
Compatibility flags: nodejs_compat

Files

File	Purpose
`wrangler.jsonc`	Cloudflare Workers configuration
`open-next.config.ts`	OpenNext build configuration
`src/middleware.ts`	Middleware (renamed from proxy.ts for compatibility)

Build and deploy

Local build

npx @opennextjs/cloudflare build

Deploy to Cloudflare

npx wrangler deploy

CI/CD

Deployment happens via GitHub Actions on push to main:

.github/workflows/cloudflare-deploy.yml
Uses CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID

Common issues

"Cloudflare worker does not have a proxy.ts"

Cause: src/proxy.ts is not supported in newer OpenNext versions
Fix: Rename to src/middleware.ts

"Unsupported version of Next.js detected"

Cause: OpenNext doesn't officially support Next.js 16 yet
Fix: Add --dangerouslyUseUnsupportedNextVersion flag to build command

"Node.js compatibility mode is required"

Cause: Missing nodejs_compat compatibility flag
Fix: Add "compatibility_flags": ["nodejs_compat"] to wrangler.jsonc

"Global fetch is not available"

Cause: Missing global_fetch_strictly_public flag
Fix: Add "compatibility_flags": ["global_fetch_strictly_public"] to wrangler.jsonc

Environment variables

Set in Cloudflare dashboard or wrangler.jsonc:

Variable	Purpose
`NEXT_RUNTIME`	Set to `edge`
`SANITY_API_CDN`	Sanity CDN URL
`SANITY_API_WRITE`	Sanity write API URL
`SANITY_AUTH_TOKEN`	Sanity auth token
`SANITY_REVALIDATE_SECRET`	Revalidation webhook secret
`CANARY_SLACK_WEBHOOK`	Canary notification webhook
`CANARY_DISCORD_WEBHOOK`	Canary notification webhook
`CANARY_EMAIL`	Canary notification email
`CANARY_HONEYTOKEN`	Canary token value
`HONEYPOT_USERNAME`	Honeypot form field
`HONEYPOT_WEBSITE`	Honeypot form field

Checklist

wrangler.jsonc has correct compatibility flags
src/middleware.ts exists (not proxy.ts)
Environment variables set in Cloudflare dashboard
CI/CD workflow has correct secrets
Build succeeds with npx @opennextjs/cloudflare build

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

accessibility-audit

무료

Audit and fix accessibility issues across the portfolio to ensure WCAG 2.1 AA compliance.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

add-a-blog-post

무료

Creates a new blog post document in the Sanity studio. Use when the user wants to write a blog post, publish an article, or schedule a future post.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

add-a-certification

무료

Creates a new certification document in the Sanity studio. Use when the user wants to add a credential, certificate, or professional accreditation to the Certifications collection.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

add-a-new-skill

무료

Adds a new skill MD file to the studio's skills collection. Use when the user wants to author a new step-by-step recipe for the studio's in-app Skills tool or the .agents mirror.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

add-a-project

무료

Creates a new project document in the Sanity studio. Use when the user wants to add a new portfolio project, a case study, or a work sample to the Projects collection.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

add-an-experience

무료

Creates a new experience document in the Sanity studio. Use when the user wants to add a job, role, internship, or work history entry to the Experience collection.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PP-Namias/Portfolio22026년 10월 16일 업데이트

PP-Namias의 스킬 모두 보기

이 스킬의 문제 신고

설치

명령으로 설치

npx skills add https://github.com/PP-Namias/Portfolio --skill opennext-cloudflare

터미널에 붙여 넣고 실행합니다(Node.js 필요). Claude Code, Codex 등 설치할 에이전트를 고를 수 있습니다.

에이전트에게 부탁하기

다음 Agent Skill을 설치해 주세요.
https://github.com/PP-Namias/Portfolio/tree/main/portfolio-v1/.agents/skills/opennext-cloudflare

먼저 SKILL.md와 첨부 파일의 내용을 확인해 수상한 처리(외부 전송, 인증 정보 읽기 등)가 없는지 확인한 뒤 Claude Code는 ~/.claude/skills/opennext-cloudflare/, Codex는 ~/.agents/skills/opennext-cloudflare/ 에 배치해 주세요.

이 문장을 그대로 Claude Code나 Codex에 보내면 내용을 확인한 뒤 설치해 줍니다.

GitHub에서 소스 보기

저장소: PP-Namias/Portfolio
스타: 2
포크: 0
카테고리: 인프라·DevOps
라이선스: MIT
원문 언어: 영어
최종 업데이트: 2026년 10월 16일

스킬은 에이전트를 위한 지시와 스크립트의 묶음입니다. cccskills는 내용의 안전성을 보증하지 않습니다. 설치하기 전에 내용을 확인하세요.