Oruva
Plugin API v1 · Resources

Case study: 3DSky Hi-Res Match

This shipped plugin shows how the UI bridge fits together in a focused search, review, and apply flow.

A real UI plugin: 3DSky Hi-Res Match

The bundled oruva.sky-match plugin is the canonical search/act split. Its search mode takes one context asset-path, contacts the five 3DSky origins its manifest declares, streams status objects, and ends with its own plugin-specific search_result; it does not modify the asset. ui.html shows the local and remote previews through read-file and fetch-image, lets the user review the gallery, and then starts apply. Apply downloads the chosen replacement and extras, streams byte-level progress, emits file_written for each saved file, and finishes with result. It is a compact model for separating a safe discovery phase from an explicit write phase without freezing the modal — and its manifest is the complete schema-2 example in the Manifest reference.

For the platform contract behind the example, continue with UI actions and Post-run reconciliation.