docs: split env templates into .env.local.example and .env.production.example

Updated README and HOSTING to reference the new env template files.

Author: whynotkimhari

.env.example .env.local.example.env.example renamed to .env.local.example

@@ -11,8 +11,6 @@ NEXT_PUBLIC_API_URL=http://localhost:8000
 
 # --- Backend Configuration ---
 FRONTEND_URL=http://localhost:3000
-GOOGLE_CLIENT_ID=...
-GOOGLE_CLIENT_SECRET=...
 JWT_SECRET_KEY=...
 SESSION_SECRET=...
 ENCRYPTION_KEY=...
@@ -23,3 +21,6 @@ MODAL_TOKEN_ID=ak-...
 MODAL_TOKEN_SECRET=as-...
 MODAL_APP_NAME=interpres-backend
 HF_TOKEN=hf_...
+# For Google OAuth
+GOOGLE_CLIENT_ID=...
+GOOGLE_CLIENT_SECRET=...

.env.production.example

@@ -0,0 +1,29 @@
+# --- Database Configuration ---
+DATABASE_URL=postgresql://interpres:interpres_secret@postgres:5432/interpres
+LANCEDB_PATH=gs://...
+UPLOADS_PATH=/uploads # For temporary saving uploaded documents 
+
+
+# --- Frontend Configuration ---
+NEXT_PUBLIC_API_URL=http://localhost:8000
+
+
+# --- Backend Configuration ---
+FRONTEND_URL=http://localhost:3000
+JWT_SECRET_KEY=...
+SESSION_SECRET=...
+ENCRYPTION_KEY=...
+
+
+# --- Third Party Services ---
+MODAL_TOKEN_ID=ak-...
+MODAL_TOKEN_SECRET=as-...
+MODAL_APP_NAME=interpres-backend
+HF_TOKEN=hf_...
+# For Google OAuth
+GOOGLE_CLIENT_ID=...
+GOOGLE_CLIENT_SECRET=...
+# For Google Cloud Service
+GOOGLE_APPLICATION_CREDENTIALS_JSON=...
+# For Vercel Blob Storage
+BLOB_READ_WRITE_TOKEN=...

HOSTING.md

@@ -1,6 +1,6 @@
 # Hosting: Local vs. Production
 
-This document outlines the architectural and configuration differences when running Interpres in a local development environment versus deploying it to a production environment (such as Railway or Vercel).
+This document outlines the architectural and configuration differences when running Interpres in a local development environment versus deploying it to a production environment (such as Railway or Vercel). See `.env.local.example` and `.env.production.example` for the corresponding environment variable templates.
 
 ## 1. Vector Database (LanceDB)
 
@@ -51,7 +51,7 @@ Transcribed manuscript images need to be stored and served to the frontend.
 
 ## 4. Environment Variables Checklist
 
-When moving from local to production, ensure the following variables are updated:
+When moving from local to production, copy `.env.production.example` and update the following variables:
 
 | Variable | Local Example | Production Example |
 | -------- | ------------- | ------------------ |

README.md

@@ -173,36 +173,37 @@ cd Interpres
 
 ### Step 2: Configure Environment Variables
 
-Copy the example environment file and fill in your credentials:
+Copy the local development environment template and fill in your credentials:
 
 ```bash
-cp .env.example .env
+cp .env.local.example .env
 ```
 
 Edit `.env` and set the following values:
 
 ```dotenv
 # --- Database Configuration ---
 DATABASE_URL=postgresql://interpres:interpres_secret@postgres:5432/interpres
+LANCEDB_DOWNLOAD_URL=https://drive.google.com/file/d/1vCbxUqTRUVlo0gYJjgZDfWx-P9YF2JZ1/view?usp=share_link
 LANCEDB_PATH=/lancedb
 UPLOADS_PATH=/uploads
 
 # --- Frontend Configuration ---
 NEXT_PUBLIC_API_URL=http://localhost:8000
 
 # --- Backend Configuration ---
-GOOGLE_CLIENT_ID=<your-google-client-id>
-GOOGLE_CLIENT_SECRET=<your-google-client-secret>
 FRONTEND_URL=http://localhost:3000
-SESSION_SECRET=<generate-a-random-string>
 JWT_SECRET_KEY=<generate-a-random-string>
+SESSION_SECRET=<generate-a-random-string>
 ENCRYPTION_KEY=<generate-a-fernet-key>
 
 # --- Third Party Services ---
 MODAL_TOKEN_ID=ak-...
 MODAL_TOKEN_SECRET=as-...
 MODAL_APP_NAME=interpres-backend
 HF_TOKEN=hf_...
+GOOGLE_CLIENT_ID=<your-google-client-id>
+GOOGLE_CLIENT_SECRET=<your-google-client-secret>
 ```
 
 To generate the required keys:
@@ -407,7 +408,8 @@ Interpres/
 |-- uv.lock                                  # Locked Python dependencies
 |-- railway.json                             # Railway deployment config
 |-- deploy_modal.sh                          # Script to deploy ML services to Modal
-|-- .env.example                             # Template for environment variables
+|-- .env.local.example                       # Local development env template
+|-- .env.production.example                  # Production env template
 |-- HOSTING.md                               # Local vs production environment guide
 |
 |-- docs/