Esempio per sviluppatori · Sprig

Hello Grove

da Mango

Un esempio Sprig Vue 3 + TypeScript per testare il ponte Grove.

Installa in Mango 3.140 KB · Mango 3.1

Versione: 0.1.0
Modalità di esecuzione: Pannello canale
Grove API: 1
Aggiornato: 2026-07-31

Autorizzazioni richieste

3 permessi

Leggi i messaggi del canaleRiceve i messaggi dal canale in cui è in esecuzione l'estensione.
Invia messaggi di canalePuò postare messaggi attribuiti al canale in cui è in esecuzione.
Mantieni i dati localiMemorizza i dati dell'estensione su questo dispositivo in uno spazio isolato a sé.

Accesso alla rete

Nessun accesso a Internet

Il suo manifesto non dichiara host esterni. Il sandbox di Grove blocca le richieste di rete fuori dal pacchetto.

Schermate

Vedilo in Mango.

Screenshot 1 di Hello Grove — Interfaccia del pannello del canale di Hello Grove.

Dall'estensione

README · Inglese

Hello Grove — sample Sprig (Vue 3 + TypeScript)

A minimal Grove extension (“Sprig”) for testing Mango’s grove-ext:// host and the window.grove bridge. See Docs/Design/grove.md for the platform design.

Build

cd Examples/grove-hello-vue
npm install
npm run build      # → dist/  (index.html + manifest.json + assets/)
npm run package    # → hello-grove.grove, ready to install on iOS or macOS

vite.config.ts sets base: './' so the built asset URLs are relative and resolve under the Sprig’s own origin. public/manifest.json is copied verbatim into dist/.

The repository’s source directory is deliberately not itself an installable Sprig: its manifest lives under public/ and its entry imports TypeScript/Vue source. Install the generated hello-grove.grove, or dev-load the built dist/ directory on macOS.

Node 18 or newer is required by the build toolchain.

Load into Mango

iPhone and iPad

Put hello-grove.grove in Files or iCloud Drive.
In Mango, open Grove Extensions and choose Install .grove….
Select the package, then press Start beside Hello Grove and approve its requested permissions.

macOS (development)

Run Mango.
Open any channel.
Click the puzzle-piece button at the top-right of the transcript.
Choose Load Unpacked (Dev)…, then select Examples/grove-hello-vue/dist.

The Sprig opens in a split-pane bound to that channel.

What it demonstrates

Reads window.grove.info.id (the Sprig identity from the bridge).
Calls window.grove.send(text) — posts to the bound channel through the native bridge → IRCFeature’s send path (capability-gated on channel.send).
Subscribes to window.grove.on('message', …) — the feed shows this channel’s messages live (capability-gated on channel.read).

Manifest

{
  "grove": 1,
  "id": "app.mango.grove.hello",
  "capabilities": ["channel.read", "channel.send"],
  "hostPermissions": []   // no network — pure local UI
}

Bridge type declarations live in src/grove.d.ts — keep them in sync with Mango/Grove/Host/GroveWebView.swift::facadeSource.

manifest.jsonapp.mango.grove.hello

{
  "grove": 1,
  "id": "app.mango.grove.hello",
  "name": "Hello Grove",
  "version": "0.1.0",
  "description": "A Vue 3 + TypeScript sample Sprig for testing the Grove bridge.",
  "author": {
    "name": "Mango",
    "url": "https://mango.app"
  },
  "readme": "README.md",
  "screenshots": [
    {
      "path": "screenshots/hello-grove.png",
      "caption": "Hello Grove's channel-pane interface."
    }
  ],
  "entry": "index.html",
  "presentation": {
    "surfaces": [
      "channelPane"
    ],
    "defaultSurface": "channelPane",
    "defaultSize": {
      "width": 340,
      "height": 460
    }
  },
  "capabilities": [
    "channel.read",
    "channel.send",
    "storage"
  ],
  "hostPermissions": []
}