.env.example

# .env.example — example environment variables for SOARCA-GUI
# Copy this file to `.env.development` for local dev or to `.env` for Docker Compose
# Notes:
#  - Vite exposes ONLY variables prefixed with `VITE_` to the client (import.meta.env).
#  - Client-visible `VITE_` values are embedded at *build time* (rebuild to change).
#  - Docker Compose reads the project `.env` for substitution and container envs.
#  - We also follow a consumer based prefix convention for clarity, so variables used by nginx start with NGINX_, those used by the dev server start with VITE_ etc.

########## Development (Vite) ##########
# Used by `npm run dev` / Vite dev server. Client-facing variables MUST start with VITE_.
# copy these lines into `.env.development` or `.env` (see Vite docs at https://vite.dev/guide/env-and-mode) and adjust as needed for local development
VITE_BACKEND_URL=http://localhost:8080 # backend API URL used by the frontend (dev server proxy target)
VITE_SERVER_PORT=5173 # dev server port

########## Docker Compose (dev) ##########
# Values used by `docker-compose.dev.yml`. Compose will substitute ${VAR} from the
# project `.env` or the shell environment when you run `docker compose`.
VITE_APP_VERSION=development
VITE_BACKEND_URL=http://host.docker.internal:8080 # backend API URL used by the frontend inside the container (host.docker.internal points to the host machine)
VITE_SERVER_PORT=5173 # dev server port inside the container
DOCKER_HOST_PORT=5173 # port on the host machine mapped to the container's VITE_SERVER_PORT (for browser access)

########## Production (nginx) ##########
# Values used at container runtime by nginx to proxy /api/
NGINX_BACKEND_URL=http://host.docker.internal:8080/  # backend API URL used by nginx inside the container (host.docker.internal points to the host machine)
NGINX_SERVER_PORT=8081 # port nginx listens on inside the container
DOCKER_HOST_PORT=8081 # port on the host machine mapped to the container's NGINX_SERVER_PORT (for browser access)