Install as PWA
Source: docs/get-started/install-pwa.md
Generated: 01/09/2026
Install JoinGrove as a Progressive Web App from a browser session — ideal for Chromebooks and low-spec clients.
Key Concepts
- What: PWA install pins JoinGrove to your app shelf with offline-capable metadata (
joingrovePwainproduct.json). - Why: Students on borrowed Chromebooks or shared PCs get a native-feeling app without a full desktop install.
- Related: Chromebook guide (
install-chromebook.md), run modes (run-modes.md).
API / Reference
| Item | Value |
|---|---|
| Install command | joingrove.installPwa |
| Theme color | #2d8659 (grove green) |
| Config | product.json → joingrovePwa |
| Backend required | REH server or sessions-web must be running |
| Default web URL | joingroveRunAnywhere.defaultEditorWebUrl |
Setup & Installation
- Start a browser-accessible JoinGrove server (
npm run sessions-webornpm run server). - Open the URL in Chrome, Edge, or Safari.
- Command Palette → Install JoinGrove as App (PWA) (
joingrove.installPwa). - Confirm the install prompt — JoinGrove appears on your app shelf.
Code Examples
Start browser Agents UI:
npm run sessions-web
Then in the browser session, use Command Palette → Install JoinGrove as App (PWA).
For classic workbench in the PWA, append to URL:
?classic=true
Next: Configure joingroveRunAnywhere.productionEditorWebUrlTemplate for production campus deployments.
How It Connects
- Chromebook install:
install-chromebook.md - Run modes:
run-modes.md - Self-hosted campus:
campus.md - In-app command:
joingrove.installPwa