merge new_starr_app@qas history into apps/web

git-subtree-dir: apps/web
git-subtree-mainline: eaa6d2276a
git-subtree-split: 459af9d46a

apps/web/.env.example

@@ -0,0 +1,38 @@
+# ═══════════════════════════════════════════════════════════════════════════════
+#  $APP_NAME — Frontend Environment Variables Template
+#  Copy to .env and fill in all CHANGE_ME values before building.
+#
+#  Self-hosted setup:
+#    1. cp .env.example .env
+#    2. Fill in every CHANGE_ME value below
+#    3. npm run build          (bakes env vars into the dist/ bundle)
+#    4. docker build -t $APP_NAME-app .
+#       (or serve dist/ with any static host — Nginx, Caddy, Vercel, etc.)
+#
+#  NOTE: These are BUILD-TIME variables (VITE_ prefix). Changing them after
+#        the build has no effect — you must rebuild to pick up new values.
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# ── API Connection ────────────────────────────────────────────────────────────
+#  Point to your backend's public URL — no trailing slash.
+#  Must match APP_URL / ALLOWED_ORIGINS in the backend .env.
+VITE_APP_NAME=starr
+VITE_API_URL=https://api.yourdomain.com/api
+VITE_APP_URL=https://api.yourdomain.com
+
+# ── Environment ───────────────────────────────────────────────────────────────
+#  "production" (droplet) or "qas" (home-hosted, behind Cloudflare Tunnel).
+#  Set to "qas" only on the QAS Preview build in Vercel's project settings.
+VITE_APP_ENV=production
+
+# ── PayPal ────────────────────────────────────────────────────────────────────
+#  Client ID is the public key — safe to expose in the browser bundle.
+#  developer.paypal.com → My Apps & Credentials → Live tab → Client ID
+VITE_PAYPAL_CLIENT_ID=CHANGE_ME
+
+# ── Country detection (phone input) ────────────────────────────────────────────
+#  IP → country lookup used to pre-select the phone input's dialing code.
+#  Defaults to the free hosted instance; self-host for production via
+#  https://github.com/lineofflight/country (Docker, needs a free MaxMind
+#  license key) and point this at your own instance instead.
+VITE_COUNTRY_API_URL=https://api.country.is