env.example

# GraphQL Proxy Configuration

# Server port
PORT=5001

# Bind host for the HTTP server (use 127.0.0.1 for local-only)
BIND_HOST=0.0.0.0

# Upstream GraphQL endpoint (source of truth)
UPSTREAM_GRAPHQL_ENDPOINT=https://example.com/graphql

# JWT token for authenticated mutations (from WPGraphQL JWT Authentication)
UPSTREAM_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

# GraphQL mode:
# - GETMODE: read-only, mutations blocked (default)
# - SETMODE: mutations execute + save locally, queue when offline
# - CRUDMODE: bidirectional sync (future, requires websockets)
GRAPHQL_MODE=GETMODE

# Cache directory for GraphQL responses
CACHE_DIR=./data/graphql-cache

# Queue directory for pending mutations (SETMODE)
QUEUE_DIR=./data/mutation-queue

# Local database for CMS offline access
LOCAL_DB_PATH=./data/local-db.json

# Path base for relative paths (CACHE_DIR/QUEUE_DIR/LOCAL_DB_PATH):
# - PATHS_RELATIVE_TO=cwd    => resolve relative paths from the working directory (default)
# - PATHS_RELATIVE_TO=script => resolve relative paths from the directory of the executable file
# - PATHS_BASE_DIR=...       => explicit base directory (overrides PATHS_RELATIVE_TO)
PATHS_RELATIVE_TO=cwd
# PATHS_BASE_DIR=./

# CORS origin (use * for development)
CORS_ORIGIN=*

# Note:
# - In Docker / Nixpacks you can also set API_PORT, but the server itself reads PORT.