Refactor for template app

.claude/settings.local.json

@@ -64,7 +64,19 @@
       "Bash(curl -s --max-time 10 \"$FACE_API_URL/health\")",
       "Bash(python3 -c \"import ast; ast.parse\\(open\\(''/Users/soniacookbroen/Development/eventlens/scripts/process_photos.py''\\).read\\(\\)\\); print\\(''OK''\\)\")",
       "Bash(npm install:*)",
-      "Bash(npx tsc:*)"
+      "Bash(npx tsc:*)",
+      "Bash(git -C /Users/soniacookbroen/Development/eventlens log --oneline -20)",
+      "Bash(ls -la /Users/soniacookbroen/Development/eventlens/CLAUDE-*.md /Users/soniacookbroen/Development/eventlens/PLAN.md /Users/soniacookbroen/Development/eventlens/EVENTLENS-MASTER-PLAN.md /Users/soniacookbroen/Development/eventlens/TEMPLATE-REVIEW.md)",
+      "Bash(grep -iE '\\\\.env|credentials|secret|\\\\.key$|\\\\.pem$')",
+      "Bash(git rm:*)",
+      "WebFetch(domain:mitodl.github.io)",
+      "Bash(sort -t'\t' -k2 -rn)",
+      "Bash(gh api:*)",
+      "Bash(gh search:*)",
+      "Bash(npx jest:*)",
+      "WebFetch(domain:api.github.com)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(npm test:*)"
     ]
   }
 }

.env.example

@@ -1,32 +1,33 @@
-# Required: Google API key with Drive API enabled
+# ─── Google Cloud ───────────────────────────────────────────────
+# Required: Google Cloud API key with Drive API enabled
 GOOGLE_API_KEY=
-
-# Required: Google Drive parent folder ID (from URL: drive.google.com/drive/folders/{THIS})
+# Required: Root Drive folder ID (from the folder URL: drive.google.com/drive/folders/{THIS})
 GOOGLE_DRIVE_FOLDER_ID=
 
-# Required: Google Sheet ID (legacy fallback; from URL: docs.google.com/spreadsheets/d/{THIS}/edit)
-GOOGLE_SHEET_ID=
-
-# Required: Gemini API key (from aistudio.google.com)
+# ─── Gemini AI ─────────────────────────────────────────────────
+# Required: Gemini API key for vision analysis and embeddings (from aistudio.google.com)
 GEMINI_API_KEY=
 
-# Required: Authentication password for app access
-APP_PASSWORD=
-
-# Required: Secret for admin API endpoints (bearer token)
-ADMIN_API_SECRET=
-
-# Required for AI metadata (text search, face counts): Supabase
+# ─── Supabase ──────────────────────────────────────────────────
+# Required: Supabase project URL and service role key
 NEXT_PUBLIC_SUPABASE_URL=
 SUPABASE_SERVICE_ROLE_KEY=
 
-# Optional: Face embedding API for vector-based face matching
-# Deploy services/face-api/ on Railway/Render/Fly, set the URL here
+# ─── Authentication ────────────────────────────────────────────
+# Required: Password attendees enter to access the gallery
+APP_PASSWORD=
+# Required: Bearer token for admin API endpoints
+ADMIN_API_SECRET=
+
+# ─── Face Matching (Optional) ─────────────────────────────────
+# Deploy services/face-api/ on Railway/Render/Fly, then set the URL here
+# If not configured, face matching features are disabled
 FACE_API_URL=
 FACE_API_SECRET=
 
-# Optional: Customize for your event
+# ─── Event Branding (Optional) ────────────────────────────────
 NEXT_PUBLIC_EVENT_NAME=Event Photos
 NEXT_PUBLIC_EVENT_TAGLINE=Find your photos
 NEXT_PUBLIC_PRIMARY_COLOR=#3b82f6
-NEXT_PUBLIC_ACCENT_COLOR=#f59e0b
+NEXT_PUBLIC_SECONDARY_COLOR=#f59e0b
+NEXT_PUBLIC_ACCENT_COLOR=#3b82f6

.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+
+      - name: Run tests
+        run: npm test -- --forceExit
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build
+        run: npm run build
+        env:
+          NEXT_PUBLIC_SUPABASE_URL: https://placeholder.supabase.co
+          NEXT_PUBLIC_SUPABASE_ANON_KEY: placeholder
+
+      - name: Notify Slack on failure
+        if: failure()
+        uses: slackapi/slack-github-action@v2.0.0
+        with:
+          webhook: ${{ secrets.SLACK_WEBHOOK_URL }}
+          webhook-type: incoming-webhook
+          payload: |
+            {
+              "text": ":red_circle: CI failed on `${{ github.ref_name }}` — ${{ github.event.head_commit.message || github.event.pull_request.title }}",
+              "blocks": [
+                {
+                  "type": "section",
+                  "text": {
+                    "type": "mrkdwn",
+                    "text": ":red_circle: *CI Failed* on `${{ github.ref_name }}`\n*Commit:* ${{ github.event.head_commit.message || github.event.pull_request.title }}\n*Run:* <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}|View logs>"
+                  }
+                }
+              ]
+            }

.gitignore

@@ -30,6 +30,10 @@ yarn-error.log*
 .env.*
 !.env.example
 
+# python (face-api service)
+__pycache__/
+*.pyc
+
 # vercel
 .vercel