Skip to content

feat: web app polish — hide unsupported features, add user guide#12

Merged
jamesagarside merged 3 commits intomainfrom
feature/web-app-polish
Apr 5, 2026
Merged

feat: web app polish — hide unsupported features, add user guide#12
jamesagarside merged 3 commits intomainfrom
feature/web-app-polish

Conversation

@jamesagarside
Copy link
Copy Markdown
Owner

Summary

  • Hide features that don't work on web (Video tab, Serial/UDP/TCP transport, SITL, log download, file export)
  • Default to WebSocket transport on web with relay info banner
  • Add comprehensive user-facing Web App Guide (web-app-guide.md)
  • Add "Try in Browser" button to website homepage
  • Update platform compatibility list to include web app
  • Update development docs with web guard patterns and corrected deployment trigger

Web UI Changes

Feature Change
Video tab Hidden from nav bar
Video/Logs/Simulate tabs Hidden from Setup
Serial/UDP/TCP transport Hidden from connection selector
Default transport WebSocket (was UDP)
Export buttons Hidden, replaced with "not available"
Relay info banner Shown in WebSocket connection panel
Keyboard shortcuts Adjusted indices (no Video tab)

Documentation

  • New: website/docs/web-app-guide.md — User guide covering relay setup, PWA install, browser compat, troubleshooting
  • Updated: website/docs/webapp.md — Dev docs with web guard patterns, corrected deploy trigger, cross-reference to user guide
  • Updated: website/index.html — "Try in Browser" hero button, web in platform list
  • Updated: website/js/docs.js, docs.html, llms.txt — Nav links

Test plan

  • 561 tests pass (verified locally)
  • Web build succeeds (flutter build web --release)
  • Video tab not visible on web
  • Only WebSocket transport shown on web
  • Export menu shows "not available" on web
  • Relay info banner visible in WebSocket panel on web
  • Web App Guide renders correctly in docs sidebar
  • "Try in Browser" button visible on homepage

- Hide Video tab from navigation on web (media_kit unavailable)
- Hide Video/Logs/Simulate tabs from Setup view on web
- Hide Serial/UDP/TCP transport options (only WebSocket on web)
- Default transport to WebSocket on web
- Hide file export buttons in Analyse view on web
- Add relay info banner to WebSocket connection panel on web
- Add kIsWeb guard to SimulatePanel platform check
- Adjust keyboard shortcut indices for web (no Video tab)
- Update development docs with web guard patterns
Add comprehensive user-facing web app guide covering:
- Feature parity table (what works, what doesn't)
- Helios Relay installation and usage
- PWA installation instructions per platform
- Browser compatibility matrix
- Flight data storage on web (IndexedDB/sql.js)
- Troubleshooting common issues

Update website:
- Add "Try in Browser" button to homepage hero
- Add web app to platform compatibility list
- Add web-app-guide to docs sidebar navigation
- Add to llms.txt for AI discoverability

Update development docs:
- Cross-reference user guide from developer docs
- Document web UI guard patterns (kIsWeb)
- Update feature parity table accuracy
- Correct deployment trigger (release, not push)
Add dismissible banner at top of app on web explaining:
- Which features are desktop-only (video, serial, SITL, file export)
- That WebSocket relay bridges to TCP/UDP
- Link to Setup > Connection for quick access

Improve WebSocket connection panel with:
- Clearer "Helios Relay Required" heading
- Explanation that relay bridges browser WebSocket to FC TCP/UDP
- Copyable install command with curl one-liner
- Step-by-step instructions
@jamesagarside jamesagarside merged commit ed38785 into main Apr 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant