Next.js + fumadocs アプリケーションを Vercel にデプロイする完全ガイド

npm run build

import { createMDX } from "fumadocs-mdx/next";
import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  reactStrictMode: true,
};

const withMDX = createMDX();

export default withMDX(nextConfig);

# dependencies
node_modules

# next.js
.next/
out/

# fumadocs generated
.source/

# environment
.env*.local

# Git リポジトリの初期化（まだの場合）
git init

# すべての変更をステージング
git add .

# コミット
git commit -m "Initial commit"

# リモートリポジトリを追加
git remote add origin https://github.com/your-username/your-repo.git

# プッシュ
git push -u origin main

例：
NEXT_PUBLIC_SITE_URL = https://your-domain.vercel.app

1. Cloning repository...
2. Installing dependencies...
   → npm install
3. Building application...
   → npm run build
   → fumadocs-mdx が MDX ファイルを処理
   → Next.js がページを生成
4. Deploying to edge network...
5. Assigning domain...

git push origin main

Type: CNAME
Name: docs（または任意のサブドメイン）
Value: cname.vercel-dns.com

Type: A
Name: @
Value: 76.76.21.21

{
  "buildCommand": "npm run build",
  "framework": "nextjs",
  "regions": ["hnd1"],
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        }
      ]
    }
  ]
}

{
  "regions": ["hnd1"]
}

{
  "redirects": [
    {
      "source": "/old-path",
      "destination": "/new-path",
      "permanent": true
    }
  ]
}

# ローカルで再現確認
rm -rf node_modules .next
npm install
npm run build

{
  "build": {
    "env": {
      "NODE_OPTIONS": "--max-old-space-size=4096"
    }
  }
}

npm install -g vercel

vercel login

# プレビューデプロイ
vercel

# 本番デプロイ
vercel --prod

vercel env pull .env.local

name: Deploy to Vercel

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install Vercel CLI
        run: npm install -g vercel@latest

      - name: Pull Vercel Environment
        run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}

      - name: Build Project
        run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}

      - name: Deploy to Vercel
        run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}