chore: standardize environment configuration by replacing .env.local with .env

Author: wiktoriavh

.github/workflows/deploy.yml

@@ -38,10 +38,10 @@ jobs:
           export NODE_VERSION=$(cat .nvmrc | sed 's/v//')
           echo "Using Node version: $NODE_VERSION"
 
-          # Create .env.local file with secrets only
+          # Create .env file with secrets
           # Public config comes from .env.production (committed to repo)
           # NODE_ENV=production is set in docker-compose.yml
-          cat > .env.local << EOF
+          cat > .env << EOF
           DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }}
           CLIENT_ID=${{ secrets.CLIENT_ID }}
           EOF

DOCKER.md

@@ -6,15 +6,15 @@ This document explains how to run the webdev-bot using Docker.
 
 - Docker installed (version 20.10 or higher)
 - Docker Compose installed (version 2.0 or higher)
-- `.env.local` file with required environment variables
+- `.env` file with required environment variables
 
 ## Node Version Management
 
 The Docker setup uses `.nvmrc` as the single source of truth for the Node.js version. The Dockerfile automatically reads this version at build time via the `NODE_VERSION` build argument. No need to manually sync versions between `.nvmrc` and Docker files.
 
 ## Environment Variables
 
-Before running the bot, create a `.env.local` file in the project root with the following variables:
+Before running the bot, create a `.env` file in the project root with the following variables:
 
 ```env
 DISCORD_TOKEN=your_discord_bot_token
@@ -104,7 +104,7 @@ Run the production container manually (after building with the NODE_VERSION arg)
 ```bash
 docker run -d \
   --name webdev-bot \
-  --env-file .env.local \
+  --env-file .env \
   --restart unless-stopped \
   webdev-bot:latest
 ```
@@ -114,7 +114,7 @@ Run the development container manually (after building with the NODE_VERSION arg
 ```bash
 docker run -it \
   --name webdev-bot-dev \
-  --env-file .env.local \
+  --env-file .env \
   -v $(pwd)/src:/app/src:ro \
   webdev-bot:dev
 ```
@@ -183,7 +183,7 @@ docker compose build --no-cache
 
 ## Best Practices
 
-1. **Never commit `.env.local`** - Keep your secrets secure
+1. **Never commit `.env`** - Keep your secrets secure
 2. **Use production profile for deployment** - Smaller, more secure images
 3. **Keep development profile for local testing** - Faster iteration with hot reload
 4. **Node version is managed in `.nvmrc`** - Update `.nvmrc` to change Node version for Docker

Dockerfile

@@ -41,8 +41,8 @@ COPY --from=deps /app/node_modules ./node_modules
 COPY --from=build /app/dist ./dist
 COPY package.json ./
 
-# Copy environment config files (public, non-secret)
-COPY .env.production .env.development ./
+# Copy environment config file (public, non-secret)
+COPY .env.production ./
 
 # Create data directory and set permissions for node user
 RUN mkdir -p /app/data && chown -R node:node /app/data

README.md

@@ -52,10 +52,10 @@ A comprehensive Discord bot designed specifically for the Web Dev Discord server
    pnpm install
    ```
 
-3. Create a `.env.local` file based on `.env.example` and fill in the required environment variables:
+3. Create a `.env` file based on `.env.example` and fill in the required environment variables:
    ```bash
-   cp .env.example .env.local
-   # Edit .env.local to add your Discord bot token and other configurations
+   cp .env.example .env
+   # Edit .env to add your Discord bot token and other configurations
    ```
 
 4. Build and start the bot:

docker-compose.yml

@@ -9,7 +9,7 @@ services:
     container_name: webdev-bot-prod
     restart: unless-stopped
     env_file:
-      - .env.local
+      - .env
     environment:
       - NODE_ENV=production
     volumes:
@@ -30,7 +30,7 @@ services:
     container_name: webdev-bot-dev
     restart: unless-stopped
     env_file:
-      - .env.local
+      - .env
     environment:
       - NODE_ENV=development
     volumes:
@@ -43,7 +43,6 @@ services:
       - ./package.json:/app/package.json:ro
       - ./pnpm-lock.yaml:/app/pnpm-lock.yaml:ro
       # Mount environment config files
-      - ./.env.development:/app/.env.development:ro
       - ./.env.production:/app/.env.production:ro
       # Persist guides tracker data
       - guides-data:/app/data

docs/GUIDE_SYNC.md

@@ -4,7 +4,7 @@ The bot automatically synchronizes guide markdown files from `src/commands/guide
 
 ## Setup
 
-Add to your `.env.local` file:
+Add to your `.env` file:
 ```
 GUIDES_CHANNEL_ID=1234567890123456789
 ```

src/env.ts

@@ -8,7 +8,7 @@ function requireEnv(key: string): string {
   const value = process.env[key];
   if (!value) {
     console.error(`❌ Required environment variable ${key} is not set`);
-    console.error('Please check your .env.local file or CI/CD configuration');
+    console.error('Please check your .env file or CI/CD configuration');
     process.exit(1);
   }
   return value;

src/loadEnvFile.ts

@@ -36,11 +36,13 @@ function loadEnvFile(filePath: string) {
 const nodeEnv = process.env.NODE_ENV || 'development';
 console.log(`🌍 Environment: ${nodeEnv}`);
 
-// Load environment-specific config first (public values)
-const envFile = join(process.cwd(), `.env.${nodeEnv}`);
-loadEnvFile(envFile);
+// Load environment-specific config first (public values, production only)
+if (nodeEnv === 'production') {
+  const envFile = join(process.cwd(), '.env.production');
+  loadEnvFile(envFile);
+}
 
-// Load local overrides and secrets second (overrides public config)
-// Required in both dev and prod for DISCORD_TOKEN
-const localEnvFile = join(process.cwd(), '.env.local');
+// Load .env file with secrets and local config (overrides public config if any)
+// Required for DISCORD_TOKEN and other secrets
+const localEnvFile = join(process.cwd(), '.env');
 loadEnvFile(localEnvFile);