Configure Next.js for static export and add GitHub Pages deployment workflow

Author: suwe-dev

.github/workflows/deploy.yml

@@ -0,0 +1,29 @@
+name: Deploy Next.js to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build and Generate static site
+        run: npm run build
+
+      - name: Deploy to GitHub Pages
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: out

next.config.mjs

@@ -1,4 +1,10 @@
 /** @type {import('next').NextConfig} */
-const nextConfig = {};
+const nextConfig = {
+    output: 'export',          // enables static export -> builds into "out/"
+    trailingSlash: true,       // creates folder/index.html structure (safer on GitHub Pages)
+    images: { unoptimized: true }, // disable Next.js image optimizer (server-only feature)
+    basePath: '',              // empty because this is the *root* user site
+    assetPrefix: undefined
+};
 
 export default nextConfig;