ci: Next static export + FTP deploy

Author: bryanmax9

.gitignore

@@ -30,6 +30,8 @@ yarn-error.log*
 
 # env files
 .env
+.env.*
+!.env.example
 
 # vercel
 .vercel

.htaccess

@@ -0,0 +1,6 @@
+RewriteEngine On
+RewriteBase /
+RewriteRule ^index\.html$ - [L]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule . /index.html [L]

deploy.yml

@@ -0,0 +1,39 @@
+name: Build & Deploy Next.js to cPanel via FTP
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install deps
+        run: npm ci
+
+      - name: Build (Next static export)
+        env:
+          NEXT_PUBLIC_BASE_URL: ${{ secrets.NEXT_PUBLIC_BASE_URL }}
+        run: npm run build     # produces out/
+
+      - name: Deploy via FTP to cPanel
+        uses: SamKirkland/FTP-Deploy-Action@v4
+        with:
+          server: ${{ secrets.FTP_HOST }}
+          username: ${{ secrets.FTP_USER }}
+          password: ${{ secrets.FTP_PASS }}
+          local-dir: out/
+          server-dir: public_html/
+          exclude: |
+            **/.git*
+            **/.github*
+            **/node_modules/**
+            **/*.map

next.config.mjs

@@ -1,4 +1,10 @@
 /** @type {import('next').NextConfig} */
-const nextConfig = {};
-
+const nextConfig = {
+  output: 'export',          // static export
+  images: { unoptimized: true }, // needed when exporting
+  // If deploying to a subfolder like /app:
+  // basePath: '/app',
+  // assetPrefix: '/app/',
+  // trailingSlash: true,
+};
 export default nextConfig;

package.json

@@ -6,7 +6,8 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "next lint"
+    "lint": "next lint",
+    "export": "next export"
   },
   "dependencies": {
     "@fortawesome/free-brands-svg-icons": "^6.6.0",