.env.example

# TuvixRSS Environment Configuration
# Copy this file to .env and customize for your setup

# =============================================================================
# Server Configuration
# =============================================================================

# Port for the API server to listen on
PORT=8080

# Environment mode: "dev" or "prod"
# In "dev" mode, CORS is enabled and JWT_SECRET warnings are non-fatal
TUVIX_ENV=dev

# =============================================================================
# Database Configuration
# =============================================================================

# Path to SQLite database file
# For local dev: relative path from packages/api directory to project root
# For Docker: absolute path within container (set in docker-compose.yml)
DATABASE_PATH=../../data/tuvix.db

# =============================================================================
# Storage Configuration
# =============================================================================

# Base path for file storage (icons, avatars, article images)
# For local dev: relative to packages/api directory
# For Docker: absolute path within container
STORAGE_BASE_PATH=./data

# Maximum file size for uploads (in bytes)
# Default: 10MB (10485760 bytes)
STORAGE_MAX_FILE_SIZE=10485760

# =============================================================================
# Image Processing
# =============================================================================

# JPEG/WebP quality for processed images (1-100)
# Higher = better quality but larger file size
IMAGE_QUALITY=85

# Maximum image dimensions (width and height in pixels)
# Images larger than this will be resized
IMAGE_MAX_WIDTH=2048
IMAGE_MAX_HEIGHT=2048

# =============================================================================
# Authentication
# =============================================================================

# JWT Secret for token signing and verification
# IMPORTANT: Generate a secure secret for production!
# Generate with: openssl rand -base64 32
# In production, this MUST be set to a secure value
JWT_SECRET=change-me-in-production

# =============================================================================
# CORS Configuration
# =============================================================================

# Allowed origin for CORS requests
# Only used in development mode (TUVIX_ENV=dev)
# For multiple origins in production, configure in reverse proxy
CORS_ORIGIN=http://localhost:5173

# =============================================================================
# RSS Fetching
# =============================================================================

# Interval for fetching RSS feeds (in minutes)
# Minimum: 5 minutes
# Default: 60 minutes
FETCH_INTERVAL_MINUTES=60