implement revisions based on repo improvements

.env.example

@@ -1,3 +1,17 @@
 NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME="<Your Cloudinary Cloud Name>"
 NEXT_PUBLIC_CLOUDINARY_API_KEY="<Your Cloudinary API Key>"
-CLOUDINARY_API_SECRET="<Your Cloudinary API Secret>"
+CLOUDINARY_API_SECRET="<Your Cloudinary API Secret>"
+
+# Optional: read-only demo mode (disables uploads, edits, deletes)
+# NEXT_PUBLIC_PHOTOCRATE_MODE="read-only"
+
+# Optional: allow Color Pop preview uploads in read-only demo (dev only)
+# NEXT_PUBLIC_PHOTOCRATE_DEMO_MODE="true"
+
+# Optional asset organization overrides
+# NEXT_PUBLIC_CLOUDINARY_ASSETS_FOLDER="photocrate"
+# NEXT_PUBLIC_CLOUDINARY_ASSETS_TAG="photocrate"
+# NEXT_PUBLIC_CLOUDINARY_LIBRARY_TAG="photocrate-library"
+# NEXT_PUBLIC_CLOUDINARY_CREATION_TAG="photocrate-creation"
+# NEXT_PUBLIC_CLOUDINARY_FAVORITES_TAG="photocrate-favorite"
+# NEXT_PUBLIC_CLOUDINARY_TRASH_TAG="photocrate-trash"

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-and-build:
+    runs-on: ubuntu-latest
+    env:
+      NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME: test-cloud
+      NEXT_PUBLIC_CLOUDINARY_API_KEY: test-key
+      CLOUDINARY_API_SECRET: test-secret
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+      - run: npm ci
+      - run: npm test
+      - run: npm run lint
+      - run: npm run build

GITHUB_METADATA.md

@@ -0,0 +1,71 @@
+# GitHub Repository Metadata — PhotoCrate
+
+Use these values in the GitHub **About** section (gear icon on the repository homepage) for [cloudinary-community/photocrate](https://github.com/cloudinary-community/photocrate).
+
+## About description
+
+Copy this into the **Description** field:
+
+```
+Next.js 15 Google Photos-style gallery: signed uploads, Admin API asset management, f_auto/q_auto delivery, AI enhancements, overlays, collages, and generative effects with Cloudinary.
+```
+
+## Topic tags
+
+Add these topics (edit as needed if GitHub rejects duplicates):
+
+```
+cloudinary
+nextjs
+react
+typescript
+image-gallery
+signed-upload
+upload-widget
+resources-by-tag
+image-transformation
+f-auto
+q-auto
+e-improve
+e-gen-restore
+e-background-removal
+overlays
+next-cloudinary
+media-management
+photo-library
+```
+
+## Update via GitHub CLI
+
+If you have the [GitHub CLI](https://cli.github.com/) installed and authenticated:
+
+```bash
+gh repo edit cloudinary-community/photocrate \
+  --description "Next.js 15 Google Photos-style gallery: signed uploads, Admin API asset management, f_auto/q_auto delivery, AI enhancements, overlays, collages, and generative effects with Cloudinary." \
+  --add-topic cloudinary \
+  --add-topic nextjs \
+  --add-topic react \
+  --add-topic typescript \
+  --add-topic image-gallery \
+  --add-topic signed-upload \
+  --add-topic upload-widget \
+  --add-topic resources-by-tag \
+  --add-topic image-transformation \
+  --add-topic f-auto \
+  --add-topic q-auto \
+  --add-topic e-improve \
+  --add-topic e-gen-restore \
+  --add-topic e-background-removal \
+  --add-topic overlays \
+  --add-topic next-cloudinary \
+  --add-topic media-management \
+  --add-topic photo-library
+```
+
+## Update via GitHub web UI
+
+1. Open https://github.com/cloudinary-community/photocrate
+2. Click the **gear icon** next to **About** in the right sidebar
+3. Paste the **Description** above
+4. Add each **Topic** tag from the list
+5. Save changes