CalvinBackup/Shadowbroker
1
0
Fork 0
mirror of https://github.com/BigBodyCobain/Shadowbroker.git synced 2026-07-09 05:47:51 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update frontend README runtime API config

Browse Source
This commit is contained in:
anntr1k3
2026-07-03 22:43:45 +04:00
parent a7d66c5289
commit 4b463f2e46
1 changed files with 23 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
frontend/README.md
+23 -25
View File
@@ -1,6 +1,6 @@
# ShadowBroker Frontend # ShadowBroker Frontend
Next.js 16 dashboard with MapLibre GL, Cesium, and Framer Motion. Next.js 16 dashboard with MapLibre GL and Framer Motion.
## Development ## Development
@@ -11,41 +11,39 @@ npm run dev # http://localhost:3000
## API URL Configuration ## API URL Configuration
The frontend needs to reach the backend (default port `8000`). Resolution order: The browser calls relative `/api/*` paths. The catch-all route handler at
`src/app/api/[...path]/route.ts` proxies those requests to the backend using
the server-side `BACKEND_URL` environment variable at request time.
1. **`NEXT_PUBLIC_API_URL`** env var — if set, used as-is (build-time, baked by Next.js) This keeps the backend URL out of the client bundle and lets Docker or other
2. **Server-side (SSR)** — falls back to `http://localhost:8000` deployments change the backend target without rebuilding the frontend.
3. **Client-side (browser)** — auto-detects using `window.location.hostname:8000`
### Common scenarios ### Common Scenarios
| Scenario | Action needed | | Scenario | Action needed |
| ----------------------------------------------- | --------------------------------------------------------------- | | --- | --- |
| Local dev (`localhost:3000` + `localhost:8000`) | None — auto-detected | | Local dev (`localhost:3000` + backend on `127.0.0.1:8000`) | None. The proxy defaults to `http://127.0.0.1:8000`. |
| LAN access (`192.168.x.x:3000`) | None — auto-detected from browser hostname | | Docker Compose | None. `docker-compose.yml` sets `BACKEND_URL=http://backend:8000`. |
| Public deploy (same host, port 8000) | None — auto-detected | | Backend on a different host or port | Set `BACKEND_URL` before starting the Next.js server/container. |
| Backend on different port (e.g. `9096`) | Set `NEXT_PUBLIC_API_URL=http://host:9096` before build | | Reverse proxy in front of the frontend | Point external clients at the frontend; keep `BACKEND_URL` set to the backend address reachable from the Next.js server. |
| Backend on different host | Set `NEXT_PUBLIC_API_URL=http://backend-host:8000` before build |
| Behind reverse proxy (e.g. `/api` path) | Set `NEXT_PUBLIC_API_URL=https://yourdomain.com` before build |
### Setting the variable ### Setting `BACKEND_URL`
```bash ```bash
# Shell (Linux/macOS) # Shell (Linux/macOS)
NEXT_PUBLIC_API_URL=http://myserver:8000 npm run build BACKEND_URL=http://myserver:8000 npm run dev
# PowerShell (Windows) # PowerShell (Windows)
$env:NEXT_PUBLIC_API_URL="http://myserver:8000"; npm run build $env:BACKEND_URL="http://myserver:8000"; npm run dev
# Docker Compose (set in .env file next to docker-compose.yml) # Docker Compose
NEXT_PUBLIC_API_URL=http://myserver:8000 # Edit the frontend service environment or add a compose override:
# BACKEND_URL=http://myserver:8000
``` ```
> **Note:** This is a build-time variable. Changing it requires rebuilding the frontend.
## Theming ## Theming
Dark mode is the default. A light/dark toggle is available in the left panel toolbar. Dark mode is the default. A light/dark toggle is available in the left panel
Theme preference is persisted in `localStorage` as `sb-theme` and applied via toolbar. Theme preference is persisted in `localStorage` as `sb-theme` and
`data-theme` attribute on `<html>`. CSS variables in `globals.css` define all applied via the `data-theme` attribute on `<html>`. CSS variables in
structural colors for both themes. `globals.css` define all structural colors for both themes.