Polytrack/online.github.io -

| Symptom | Likely Cause | Quick Fix | |---------|--------------|-----------| | | npm ci not run after a fresh clone. | Run npm ci again, then npm run build . | | Live demo widgets don’t receive data | The demo WebSocket endpoint ( wss://demo.polytrack.io ) is down. | Switch to the local mock server: npm run mock-server and set window.POLYTRACK_WS_URL = "ws://localhost:4000" in the console. | | Search returns “no results” | Algolia index not updated after a docs change. | Push a new commit; the GitHub Action automatically re‑indexes. | | GitHub Pages shows a 404 after a PR merge | The workflow failed to deploy (check the Actions tab). | Fix the failing step (often a lint error) and push a new commit. |

| Asset | Description | |------|-------------| | ( index.html ) | Landing page, live demo widgets, and quick links | | Docs ( /docs/ ) | Markdown‑driven user guide, API reference, tutorials | | Demo apps ( /demo/ ) | Mini‑applications showcasing core widgets (charts, maps, dashboards) | | Assets ( /assets/ ) | CSS, JS bundles, icons, images, and the custom Polytrack UI theme | | GitHub Actions ( .github/workflows/ ) | CI pipeline that builds, lints, and deploys the site automatically on each push | polytrack/online.github.io

Every millisecond matters; players race against their own "ghosts" or global leaderboards to shave off seconds. | Symptom | Likely Cause | Quick Fix

| Resource | Link | |----------|------| | | https://polytrack.github.io | | API Reference | https://polytrack.github.io/docs/api/ | | Developer Guide | https://polytrack.github.io/docs/dev/ | | GitHub Actions Workflow | https://github.com/polytrack/online.github.io/blob/main/.github/workflows/deploy.yml | | Discussion Forum | https://github.com/polytrack/online.github.io/discussions | | Roadmap | https://github.com/polytrack/online.github.io/projects/1 | | Switch to the local mock server: npm