Initial commit: TSS Bot Web Frontend (React/Vite + production server)

2026-07-02 02:09:34 +00:00
commit 36092f0269
87 changed files with 34597 additions and 0 deletions
@@ -0,0 +1,50 @@
+# tssbot.web-frontend
+
+React/Vite frontend and production Node.js server for the TSS Bot web platform.
+
+## Structure
+
+- `frontend/` - React SPA (Vite + Tailwind v4)
+- `server.cjs` - Production Node.js server (serves SPA, proxies API, analytics, uptime)
+- `webhook.cjs` - GitHub deploy webhook listener
+- `systemd/` - systemd unit files for all services
+- `scripts/` - Deployment and test scripts
+
+## Development
+
+```bash
+npm install
+cp example.env .env  # edit with your values
+npm run dev          # Vite dev server on :3001
+```
+
+## Build
+
+```bash
+npm run build        # Outputs to dist/
+```
+
+## Production
+
+```bash
+npm run build
+node server.cjs      # Serves on PORT (default 3010)
+```
+
+## Deploy Webhook
+
+```bash
+node webhook.cjs     # Listens on WEBHOOK_PORT (default 3011)
+```
+
+## Environment Variables
+
+See `example.env` for all available variables. Key ones:
+
+| Variable | Description |
+|---|---|
+| `PORT` | Server port (default: 3010) |
+| `API_UPSTREAM` | Backend API URL (default: http://127.0.0.1:6000) |
+| `PUBLIC_ORIGIN` | Public-facing URL |
+| `VITE_TURNSTILE_SITE_KEY` | Cloudflare Turnstile public key |
+| `TURNSTILE_SECRET_KEY` | Cloudflare Turnstile secret key |