.env.example

# Environment Setup

This file documents required environment variables for local development and production builds.

## Local Development (.env.local)

```env
# Vite mode
VITE_APP_ENV=development

# API endpoints
VITE_API_BASE_URL=http://localhost:3000/api
VITE_RSS_PROXY_URL=http://localhost:3000/proxy

# Feature flags
VITE_ENABLE_ANALYTICS=false
VITE_ENABLE_NOTIFICATIONS=true
VITE_DEBUG_LOGGING=true

# App version (used for cache versioning)
VITE_APP_VERSION=0.1.0
```

## Production (.env.production)

```env
# Vite mode
VITE_APP_ENV=production

# API endpoints (update with actual production URLs)
VITE_API_BASE_URL=https://api.rss-reader.app
VITE_RSS_PROXY_URL=https://api.rss-reader.app/proxy

# Feature flags
VITE_ENABLE_ANALYTICS=true
VITE_ENABLE_NOTIFICATIONS=true
VITE_DEBUG_LOGGING=false

# App version
VITE_APP_VERSION=0.1.0
```

## Using Environment Variables

In your code, access variables using `import.meta.env`:

```typescript
// src/services/api.ts
const apiUrl = import.meta.env.VITE_API_BASE_URL;
const isDevelopment = import.meta.env.DEV;
const isProduction = import.meta.env.PROD;

if (import.meta.env.VITE_DEBUG_LOGGING) {
  logger.debug('Debug mode enabled');
}
```

## Notes

- Environment variables must start with `VITE_` to be exposed to client-side code
- Never commit `.env.local` files (add to `.gitignore`)
- Production builds automatically strip debug logging
- Service Worker respects app version for cache busting

AI_API_KEY=your_api_key_here
AI_BASE_URL=https://api.openai.com/v1
AI_MODEL=glm-5