api.env.example

# API PROPERTIES
# VERSION is build-stamped into the image (CI build-arg -> ENV VERSION; "dev" locally).
# Do NOT set it here -- a value in this env_file would override the baked short-SHA.
TZ=America/New_York
LOG_LEVEL=INFO
API_PORT=5004

# COMMUNICATION PROPERTIES
WEBAPP_HOST=https://halloween.stormerg.com

# AUTH PROPERTIES (secret -- filled in from the Shared dir at deploy time; required)
API_KEY=

# CREDENTIAL PROPERTIES (secret -- filled in from the Shared dir at deploy time)
FIREBASE_CONFIG_JSON=

# EMAIL PROPERTIES (EMAIL_SENDER / EMAIL_PASSWORD are secret -- left blank)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=465
EMAIL_SENDER=
EMAIL_PASSWORD=

# PRIZE PROPERTIES (optional yearly gift-card reward; GIFT_CARD_CODE is secret -- left blank)
# Active ONLY when all three are set and GIFT_CARD_YEAR matches the season's year, otherwise
# the prize is never mentioned or sent anywhere. When active: the label is announced in the
# season-start and welcome emails, and the redemption code is emailed to exactly one winner
# at season close (ties broken by most fight wins, then earliest to reach the top score,
# then earliest signup). GIFT_CARD_CODE may be a plain code OR a redemption URL -- an
# http(s) URL is rendered as a clickable link, anything else as a letter-spaced code box.
# Update all three each season: edit this file in the repo dir on the
# Pi and redeploy (sh scripts/deploy.sh). Example: "$50 Amazon gift card" / "XXXX-YYYY" / 2026
GIFT_CARD_LABEL=
GIFT_CARD_CODE=
GIFT_CARD_YEAR=

# QA ONLY -- leave blank/unset in production.
# EVENT_ROOT isolates the database node (default: halloween-event). Point it at a
# sandbox so QA never reads or writes real data, e.g. EVENT_ROOT=qa-halloween-event
# EVENT_ROOT=
# EMAIL_OVERRIDE_RECIPIENT redirects ALL outgoing mail to one address during QA.
# EMAIL_OVERRIDE_RECIPIENT=