clxud
51 lines
1.2 KiB
Markdown
51 lines
1.2 KiB
Markdown
# 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 |
|