75 lines
2.9 KiB
YAML
75 lines
2.9 KiB
YAML
name: Point Cloud Viewer → GitHub Pages
|
|
|
|
# Publishes the live 3D point cloud viewer to gh-pages/pointcloud/.
|
|
# The viewer defaults to a synthetic in-browser demo; users can append
|
|
# ?backend=<url> or ?backend=auto to point it at a real ruview-pointcloud
|
|
# server (CORS-permitting host required). See ADR-094.
|
|
#
|
|
# Uses keep_files: true to preserve the existing observatory/, pose-fusion/,
|
|
# nvsim/, and root index.html demos already on gh-pages.
|
|
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
paths:
|
|
- 'v2/crates/wifi-densepose-pointcloud/src/viewer.html'
|
|
- '.github/workflows/pointcloud-pages.yml'
|
|
workflow_dispatch:
|
|
|
|
permissions:
|
|
contents: write
|
|
|
|
concurrency:
|
|
group: pointcloud-pages
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
build-and-deploy:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: Checkout main
|
|
uses: actions/checkout@v4
|
|
|
|
- name: Stage viewer for Pages
|
|
run: |
|
|
mkdir -p _site/pointcloud
|
|
cp v2/crates/wifi-densepose-pointcloud/src/viewer.html _site/pointcloud/index.html
|
|
# Drop a tiny README so direct browsers of the directory get context.
|
|
cat > _site/pointcloud/README.md <<'EOF'
|
|
# RuView — Live 3D Point Cloud Viewer
|
|
|
|
Hosted at: https://ruvnet.github.io/RuView/pointcloud/
|
|
|
|
## Modes
|
|
|
|
- Default — synthetic in-browser demo (no backend, no network calls).
|
|
- `?backend=auto` — fetch from `/api/splats` on the same origin
|
|
(only works when the viewer is served by `ruview-pointcloud serve`).
|
|
- `?backend=<url>` — fetch from `<url>/api/splats`. The intended
|
|
local-ESP32 use is `?backend=http://127.0.0.1:9880`: run
|
|
`ruview-pointcloud serve --bind 127.0.0.1:9880` on the same
|
|
machine with your ESP32 streaming CSI to UDP port 3333, then
|
|
visit the URL above. The local server's CorsLayer permits
|
|
requests from `https://ruvnet.github.io`, and modern browsers
|
|
permit HTTPS→127.0.0.1 mixed-content as a trustworthy origin.
|
|
The "📡 Connect ESP32" button in the viewer prompts for this
|
|
URL and persists it in localStorage.
|
|
- `?live=1` — require a live backend; show an offline message instead
|
|
of falling back to the synthetic demo.
|
|
|
|
See ADR-094 for the deployment design.
|
|
EOF
|
|
|
|
- name: Deploy to gh-pages/pointcloud/
|
|
uses: peaceiris/actions-gh-pages@v4
|
|
with:
|
|
github_token: ${{ secrets.GITHUB_TOKEN }}
|
|
publish_dir: ./_site/pointcloud
|
|
destination_dir: pointcloud
|
|
# CRITICAL: preserves observatory/, pose-fusion/, nvsim/, and root
|
|
# index.html already on gh-pages.
|
|
keep_files: true
|
|
commit_message: 'deploy(pointcloud): ${{ github.sha }}'
|
|
user_name: 'github-actions[bot]'
|
|
user_email: 'github-actions[bot]@users.noreply.github.com'
|