-feat: add self-hosted Docker image (roadmap)

.dockerignore

@@ -0,0 +1,36 @@
+# Dependencies and build artifacts
+node_modules
+dist
+.git
+.gitignore
+
+# IDE and OS
+.vscode
+.idea
+*.log
+.DS_Store
+Thumbs.db
+
+# Env and secrets (mount at runtime)
+.env
+.env.local
+.env.*.local
+
+# Tauri build outputs (not needed for Docker image)
+src-tauri/target
+
+# Tests and dev
+e2e
+tests
+*.spec.ts
+*.test.mjs
+playwright
+playwright.config.*
+
+# Docs and meta (optional: remove if you want them in image)
+docs
+*.md
+!README.md
+
+# Desktop packaging
+scripts/desktop-package.mjs

.env.example

@@ -0,0 +1,120 @@
+# ============================================
+# World Monitor — Environment Variables
+# ============================================
+# Copy this file to .env.local and fill in the values you need.
+# All keys are optional — the dashboard works without them,
+# but the corresponding features will be disabled.
+#
+#   cp .env.example .env.local
+#
+# ============================================
+
+
+# ------ AI Summarization (Vercel) ------
+
+# Groq API (primary — 14,400 req/day on free tier)
+# Get yours at: https://console.groq.com/
+GROQ_API_KEY=
+
+# OpenRouter API (fallback — 50 req/day on free tier)
+# Get yours at: https://openrouter.ai/
+OPENROUTER_API_KEY=
+
+
+# ------ Cross-User Cache (Vercel — Upstash Redis) ------
+
+# Used to deduplicate AI calls and cache risk scores across visitors.
+# Create a free Redis database at: https://upstash.com/
+UPSTASH_REDIS_REST_URL=
+UPSTASH_REDIS_REST_TOKEN=
+
+
+# ------ Market Data (Vercel) ------
+
+# Finnhub (primary stock quotes — free tier available)
+# Register at: https://finnhub.io/
+FINNHUB_API_KEY=
+
+
+# ------ Energy Data (Vercel) ------
+
+# U.S. Energy Information Administration (oil prices, production, inventory)
+# Register at: https://www.eia.gov/opendata/
+EIA_API_KEY=
+
+
+# ------ Economic Data (Vercel) ------
+
+# FRED (Federal Reserve Economic Data)
+# Register at: https://fred.stlouisfed.org/docs/api/api_key.html
+FRED_API_KEY=
+
+
+# ------ Aircraft Tracking (Vercel) ------
+
+# Wingbits aircraft enrichment (owner, operator, type)
+# Contact: https://wingbits.com/
+WINGBITS_API_KEY=
+
+
+# ------ Conflict & Protest Data (Vercel) ------
+
+# ACLED (Armed Conflict Location & Event Data — free for researchers)
+# Register at: https://acleddata.com/
+ACLED_ACCESS_TOKEN=
+
+
+# ------ Internet Outages (Vercel) ------
+
+# Cloudflare Radar API (requires free Cloudflare account with Radar access)
+CLOUDFLARE_API_TOKEN=
+
+
+# ------ Satellite Fire Detection (Vercel) ------
+
+# NASA FIRMS (Fire Information for Resource Management System)
+# Register at: https://firms.modaps.eosdis.nasa.gov/
+NASA_FIRMS_API_KEY=
+
+
+# ------ Railway Relay (scripts/ais-relay.cjs) ------
+# The relay server handles AIS vessel tracking and OpenSky aircraft data.
+# Deploy on Railway with: node scripts/ais-relay.cjs
+
+# AISStream API key for live vessel positions
+# Get yours at: https://aisstream.io/
+AISSTREAM_API_KEY=
+
+# OpenSky Network OAuth2 credentials (higher rate limits for cloud IPs)
+# Register at: https://opensky-network.org/
+OPENSKY_CLIENT_ID=
+OPENSKY_CLIENT_SECRET=
+
+
+# ------ Railway Relay Connection (Vercel → Railway) ------
+
+# Server-side URL (https://) — used by Vercel edge functions to reach the relay
+WS_RELAY_URL=
+
+# Client-side URL (wss://) — used by the browser to connect via WebSocket
+VITE_WS_RELAY_URL=
+
+
+# ------ Public Data Sources (no keys required) ------
+
+# UCDP (Uppsala Conflict Data Program) — public API, no auth
+# UNHCR (UN Refugee Agency) — public API, no auth (CC BY 4.0)
+# Open-Meteo — public API, no auth (processes Copernicus ERA5)
+# WorldPop — public API, optional key for higher rate limits
+# WORLDPOP_API_KEY=
+
+
+# ------ Site Configuration ------
+
+# Site variant: "full" (worldmonitor.app) or "tech" (tech.worldmonitor.app)
+VITE_VARIANT=full
+
+# Map interaction mode:
+# - "flat" keeps pitch/rotation disabled (2D interaction)
+# - "3d" enables pitch/rotation interactions (default)
+VITE_MAP_INTERACTION_MODE=3d