MCP HubMCP Hub
← 스킬 목록으로 돌아가기

scaffold-nextjs-app

pjt222
업데이트됨 5 days ago
7 조회
17
2
17
GitHub에서 보기
메타reactapidesign

정보

이 스킬은 App Router, TypeScript, 그리고 현대적이고 프로덕션 준비가 완료된 기본 설정을 갖춘 새로운 Next.js 애플리케이션의 기반을 구축합니다. 프로젝트 생성, 디렉토리 구조 설정, 라우팅 구성, 초기 설정을 처리합니다. 서버 사이드 렌더링이 필요한 React 기반 프론트엔드 또는 API 라우트를 포함한 풀스택 애플리케이션을 개발하는 새로운 웹 애플리케이션 프로젝트를 시작할 때 사용하세요.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/scaffold-nextjs-app

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

構建 Next.js 應用腳手架

以 App Router、TypeScript 與生產就緒之預設建立 Next.js 應用。

適用時機

  • 新建網頁應用項目
  • 建立含伺服器端渲染之 React 前端
  • 建構含 API 路由之全端應用
  • 從頭設置 TypeScript 網頁項目

輸入

  • 必要：應用名
  • 必要：套件管理器偏好（npm、yarn、pnpm）
  • 選擇性：是否含 Tailwind CSS（預設：是）
  • 選擇性：是否含 ESLint（預設：是）
  • 選擇性：src/ 目錄結構（預設：是）

步驟

步驟一：建立項目

npx create-next-app@latest my-app \
  --typescript \
  --tailwind \
  --eslint \
  --app \
  --src-dir \
  --import-alias "@/*"

回應提示或用旗標非互動式設定所有選項。

預期： 項目目錄已建立，所有依賴已安裝。

失敗時： 檢查 Node.js 版本（node --version，須 >= 18.17）。確保 npx 可用。若命令於提示處懸停，加入 --use-npm 旗標（或 --use-pnpm／--use-yarn）以跳過套件管理器提示。

步驟二：驗證項目結構

my-app/
├── src/
│   ├── app/
│   │   ├── layout.tsx        # Root layout
│   │   ├── page.tsx          # Home page
│   │   ├── globals.css       # Global styles
│   │   └── favicon.ico
│   └── lib/                  # Shared utilities (create manually)
├── public/                   # Static assets
├── next.config.ts            # Next.js configuration
├── tailwind.config.ts        # Tailwind configuration
├── tsconfig.json             # TypeScript configuration
├── package.json
└── .eslintrc.json

預期： 所有列出之目錄與文件皆存在。

失敗時： 若 src/ 目錄缺失，未傳 --src-dir 旗標。重新執行 create-next-app 附該旗標，或手動將文件移入 src/app/。

步驟三：配置 Next.js

依項目需求編輯 next.config.ts：

import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  // Enable React strict mode
  reactStrictMode: true,

  // Image optimization domains
  images: {
    remotePatterns: [
      {
        protocol: "https",
        hostname: "example.com",
      },
    ],
  },
};

export default nextConfig;

預期： next.config.ts 儲存無 TypeScript 錯誤。

失敗時： 若文件用 .js 副檔名而非 .ts，重新命名之。確保 NextConfig 類型自 "next" 引入。

步驟四：設置目錄慣例

建立常用目錄：

mkdir -p src/app/api
mkdir -p src/components
mkdir -p src/lib
mkdir -p src/types

預期： 四目錄皆於 src/ 下建立。

失敗時： 若 src/ 不存在，先建立之或調整路徑以符合項目結構（非 src 佈局於根用 app/）。

步驟五：建立基底佈局

編輯 src/app/layout.tsx：

import type { Metadata } from "next";
import { Inter } from "next/font/google";
import "./globals.css";

const inter = Inter({ subsets: ["latin"] });

export const metadata: Metadata = {
  title: "My Application",
  description: "Application description",
};

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body className={inter.className}>{children}</body>
    </html>
  );
}

預期： 佈局以 Inter 字體渲染並包覆所有頁面。

失敗時： 若字體載入失敗，檢查網路存取。將 Inter 暫時換為系統字體後備。

步驟六：加入範例 API 路由

建立 src/app/api/health/route.ts：

import { NextResponse } from "next/server";

export async function GET() {
  return NextResponse.json({ status: "ok", timestamp: new Date().toISOString() });
}

預期： 文件已建於 src/app/api/health/route.ts。

失敗時： 確保 api/health/ 目錄存在。文件須匯出具名 HTTP 方法處理器（GET、POST 等），非預設匯出。

步驟七：執行開發伺服器

cd my-app
npm run dev

預期： 應用於 http://localhost:3000 運行。

失敗時： 檢查 Node.js 版本（>= 18.17）。若依賴缺失，執行 npm install。

驗證

  • npm run dev 無錯誤啟動
  • 首頁於 localhost:3000 載入
  • TypeScript 編譯成功
  • Tailwind CSS 類別已套用
  • API 路由於 /api/health 回應
  • ESLint 無錯誤執行（npm run lint）

常見陷阱

  • Node.js 版本：Next.js 需 Node.js >= 18.17。以 node --version 檢查。
  • 連接埠衝突：預設 3000 連接埠可能被佔。改用 npm run dev -- -p 3001。
  • 引入別名混淆：@/* 對應 src/*。勿與 node_modules 引入混淆。
  • Pages 對 App Router：確保用 App Router（src/app/）非 Pages Router（src/pages/）。

相關技能

  • setup-tailwind-typescript - 詳細 Tailwind 與 TypeScript 配置
  • deploy-to-vercel - 部署腳手架應用
  • configure-git-repository - 版本控制設置

GitHub 저장소

pjt222/agent-almanac
경로: i18n/wenyan-lite/skills/scaffold-nextjs-app
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

content-collections

메타

이 스킬은 콘텐츠 콜렉션(Content Collections)을 위한 프로덕션 검증된 설정을 제공합니다. 콘텐츠 콜렉션은 Markdown/MDX 파일을 Zod 검증이 포함된 타입 안전한 데이터 콜렉션으로 변환해주는 TypeScript 최우선 도구입니다. 블로그, 문서 사이트 또는 콘텐츠 중심의 Vite + React 애플리케이션을 구축할 때 타입 안전성과 자동 콘텐츠 검증을 보장하기 위해 사용하세요. Vite 플러그인 구성과 MDX 컴파일부터 배포 최적화 및 스키마 검증에 이르기까지 모든 것을 다룹니다.

스킬 보기

polymarket

메타

이 스킬은 개발자들이 Polymarket 예측 시장 플랫폼을 활용한 애플리케이션을 구축할 수 있도록 지원하며, 거래 및 시장 데이터를 위한 API 통합 기능을 포함합니다. 또한 WebSocket을 통한 실시간 데이터 스트리밍을 제공하여 실시간 거래와 시장 활동을 모니터링할 수 있습니다. 이를 통해 거래 전략을 구현하거나 실시간 시장 업데이트를 처리하는 도구를 생성하는 데 활용할 수 있습니다.

스킬 보기

creating-opencode-plugins

메타

이 스킬은 개발자들이 명령어, 파일, LSP 작업 등 25개 이상의 이벤트 유형에 연결되는 OpenCode 플러그인을 만들 수 있도록 돕습니다. JavaScript/TypeScript 모듈을 위한 플러그인 구조, 이벤트 API 명세, 구현 패턴을 제공합니다. OpenCode AI 어시스턴트의 라이프사이클을 사용자 정의 이벤트 기반 로직으로 가로채거나, 모니터링하거나, 확장해야 할 때 사용하세요.

스킬 보기

sglang

메타

SGLang은 RadixAttention 프리픽스 캐싱을 활용하여 JSON, 정규식, 에이전트 워크플로우를 위한 고속 구조화 생성에 특화된 고성능 LLM 서빙 프레임워크입니다. 특히 반복되는 프리픽스가 있는 작업에서 상당히 빠른 추론 속도를 제공하여 복잡한 구조화 출력 및 다중 턴 대화에 이상적입니다. 제약 디코딩이 필요하거나 광범위한 프리픽스 공유가 있는 애플리케이션을 구축할 때는 vLLM과 같은 대안보다 SGLang을 선택하십시오.

스킬 보기