Merge pull request #36 from PMS61/main

fix: upgrade to Node 20, remove husky, fix Cloudflare

Author: PMS61

.dev.vars.example

@@ -0,0 +1,18 @@
+# Cloudflare Pages Development Variables
+# Copy this file to .dev.vars and fill in your values
+# DO NOT commit .dev.vars to git
+
+# Google OAuth
+GOOGLE_CLIENT_ID=your_google_client_id_here
+GOOGLE_CLIENT_SECRET=your_google_client_secret_here
+
+# NextAuth
+NEXTAUTH_SECRET=your_nextauth_secret_here
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key_here
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key_here
+
+# JWT
+JWT_SECRET=your_jwt_secret_here

.gitignore

@@ -31,6 +31,7 @@ yarn-error.log*
 .env.development
 .env
 .env.example
+.dev.vars
 
 
 # vercel

.husky/commit-msg

@@ -1 +1 @@
-18.18.0
+20

.husky/pre-commit

@@ -1 +1 @@
-18.18.0
+20

.husky/pre-receive

@@ -0,0 +1,183 @@
+# Cloudflare Pages Deployment Guide
+
+This guide covers deploying the COC Website to Cloudflare Pages using `@cloudflare/next-on-pages`.
+
+## Prerequisites
+
+- Node.js >= 20.0.0 (check with `node -v`)
+- Cloudflare account
+- Wrangler CLI installed (`npm install -g wrangler`)
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Configure Wrangler
+
+Login to your Cloudflare account:
+
+```bash
+npx wrangler login
+```
+
+### 3. Add Secrets
+
+All sensitive environment variables must be added as Cloudflare secrets (not in `wrangler.toml`):
+
+```bash
+# Google OAuth
+npx wrangler secret put GOOGLE_CLIENT_ID
+npx wrangler secret put GOOGLE_CLIENT_SECRET
+
+# NextAuth
+npx wrangler secret put NEXTAUTH_SECRET
+
+# Supabase
+npx wrangler secret put NEXT_PUBLIC_SUPABASE_ANON_KEY
+npx wrangler secret put SUPABASE_SERVICE_ROLE_KEY
+
+# JWT
+npx wrangler secret put JWT_SECRET
+```
+
+You'll be prompted to enter each value interactively.
+
+### 4. Local Development
+
+For local testing with Wrangler:
+
+1. Copy `.dev.vars.example` to `.dev.vars`:
+   ```bash
+   cp .dev.vars.example .dev.vars
+   ```
+
+2. Fill in your values in `.dev.vars`
+
+3. Run the development server:
+   ```bash
+   npx wrangler pages dev -- npm run dev
+   ```
+
+### 5. Deploy to Cloudflare Pages
+
+#### Option A: Direct Upload (Recommended for CI/CD)
+
+```bash
+npm run build
+npx @cloudflare/next-on-pages@1
+npx wrangler pages deploy .vercel/output --project-name=coc-website
+```
+
+#### Option B: GitHub Integration
+
+1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com)
+2. Navigate to **Pages** → **Create a project**
+3. Connect your GitHub repository
+4. Configure build settings:
+   - **Build command**: `npx @cloudflare/next-on-pages@1`
+   - **Build output directory**: `.vercel/output/static`
+   - **Root directory**: `/`
+5. Add all secrets in **Settings** → **Environment variables** → **Production** → **Add variable**
+
+### 6. Environment Variables in Cloudflare Dashboard
+
+For non-secret variables, add them in the Cloudflare Pages dashboard:
+
+1. Go to your project settings
+2. Navigate to **Environment variables**
+3. Add:
+   - `NEXT_OUTPUT_STANDALONE` = `false`
+   - `NODE_VERSION` = `20`
+
+## Troubleshooting
+
+### Build Fails with "Unsupported engine"
+
+Ensure you're using Node.js >= 20.0.0:
+
+```bash
+node -v  # Should show v20.x.x or higher
+nvm use 20  # If using nvm
+```
+
+### Missing Secrets
+
+If you see errors about missing environment variables at runtime:
+
+```bash
+# List all secrets
+npx wrangler secret list
+
+# Re-add any missing secrets
+npx wrangler secret put <SECRET_NAME>
+```
+
+### Middleware Issues
+
+The middleware uses Supabase for authentication. Ensure:
+- `SUPABASE_SERVICE_ROLE_KEY` is correctly set as a secret
+- Your Supabase project is accessible from Cloudflare's edge network
+
+### Worker Size Limit Exceeded
+
+If your build exceeds Cloudflare's worker size limit:
+
+1. Check for large dependencies in your bundle
+2. Use dynamic imports for heavy components
+3. Consider moving server-heavy logic to API routes
+
+## Project Structure
+
+```
+├── .dev.vars.example    # Template for local development variables
+├── wrangler.toml        # Cloudflare Pages configuration
+├── next.config.mjs      # Next.js config (standalone output disabled for Cloudflare)
+└── middleware.ts        # Edge middleware for auth protection
+```
+
+## Configuration Files
+
+### wrangler.toml
+
+```toml
+name = "coc-website"
+compatibility_flags = ["nodejs_compat"]
+compatibility_date = "2025-01-01"
+
+[build]
+command = "npx @cloudflare/next-on-pages@1"
+
+[vars]
+NODE_VERSION = "20"
+NEXT_OUTPUT_STANDALONE = "false"
+```
+
+### next.config.mjs
+
+The `output: 'standalone'` setting is disabled for Cloudflare builds. It's only enabled for Docker deployments via the `NEXT_OUTPUT_STANDALONE` environment variable.
+
+## Useful Commands
+
+```bash
+# Check Wrangler version
+wrangler --version
+
+# View deployment logs
+npx wrangler pages deployment list
+
+# Tail deployment logs
+npx wrangler tail
+
+# Open project in browser
+npx wrangler pages project open coc-website
+```
+
+## Additional Resources
+
+- [Cloudflare Pages Documentation](https://developers.cloudflare.com/pages/)
+- [next-on-pages GitHub](https://github.com/cloudflare/next-on-pages)
+- [Wrangler CLI Docs](https://developers.cloudflare.com/workers/wrangler/)

.node-version

@@ -1,5 +1,5 @@
 # Stage 1: Dependencies
-FROM node:22-alpine AS deps
+FROM node:20-alpine AS deps
 WORKDIR /app
 
 # Install dependencies needed for build
@@ -12,7 +12,7 @@ COPY package*.json ./
 RUN npm ci --ignore-scripts
 
 # Stage 2: Builder
-FROM node:22-alpine AS builder
+FROM node:20-alpine AS builder
 WORKDIR /app
 
 # Copy dependencies from deps stage
@@ -23,12 +23,22 @@ COPY . .
 ENV NEXT_TELEMETRY_DISABLED=1
 ENV NODE_ENV=production
 ENV HUSKY=0
+ENV NEXT_OUTPUT_STANDALONE=true
+
+# Required for build-time environment variable validation
+# These values are validated at runtime and can be placeholders for build
+ENV NEXT_PUBLIC_SUPABASE_URL=https://placeholder.supabase.co
+ENV SUPABASE_SERVICE_ROLE_KEY=placeholder_key_for_build_only
+ENV GOOGLE_CLIENT_ID=placeholder_for_build
+ENV GOOGLE_CLIENT_SECRET=placeholder_for_build
+ENV NEXTAUTH_SECRET=placeholder_for_build
+ENV JWT_SECRET=placeholder_for_build
 
 # Build application
 RUN npm run build
 
 # Stage 3: Production image
-FROM node:22-alpine AS runner
+FROM node:20-alpine AS runner
 WORKDIR /app
 
 # Set environment variables