webview-ui

Build and validate Pulp WebView interfaces with native bridge and embedded assets.

13|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/danielraffel/pulp --skill webview-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webview-ui
Source: https://github.com/danielraffel/pulp/tree/main/.agents/skills/webview-ui
Command: npx skills add https://github.com/danielraffel/pulp --skill webview-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pulp's WebView UI layer requires careful coordination between native hosts, embedded or development assets, and a JavaScript bridge; this Skill reduces the friction of iterating, validating, and packaging those WebView-driven panels and tools so developers can prove functionality without misconfiguring the platform or bundler.

Core Features & Use Cases

  • Loading modes: guidance for simple inline HTML, embedded bundled assets for offline distribution, and directory-backed dev assets for rapid iteration.
  • Bridge contract & runtime: documents the window.pulp messaging patterns, native message handlers, asynchronous JS evaluation, and AssetManager usage to register embedded resources.
  • Monaco integration: prescribes an ESM bundling workflow, worker file handling, and how to point Monaco worker URLs so editor features and CSS load correctly.
  • Platform notes & validation: explains the PULP_BUILD_WEBVIEW opt-in, platform-specific requirements for macOS, Windows, and Linux, and focused test/build targets for validation.
  • Use case: quickly iterate a Monaco-based in-app editor during development using directory-backed assets, then produce an embedded, offline-ready bundle for shipping.

Quick Start

Build the WebView test target with PULP_BUILD_WEBVIEW=ON, run the focused pulp-test-webview test, and inspect the native host bridge messages to confirm the page reaches editor ready.

Frequently Asked Questions about webview-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and validate a WebView UI with native bridge messaging?

To build and validate a WebView UI, enable PULP_BUILD_WEBVIEW=ON and run the focused pulp-test-webview target to inspect native host bridge messages and confirm the page reaches editor ready. This coordinates native hosts with the JavaScript bridge.

What is the best way to bundle Monaco editor workers for a WebView panel?

Bundling Monaco editor workers for a WebView panel requires an ESM bundling workflow that explicitly configures worker file handling and worker URLs. This ensures editor features and CSS load correctly across macOS, Windows, and Linux.

Can I use directory-backed assets for rapid WebView UI development?

Yes, you can use directory-backed dev assets for rapid iteration during development, then switch to embedded bundled assets via AssetManager for offline-ready distribution. This supports inline HTML, embedded assets, and directory resource fetchers.

Does the Pulp WebView bridge support macOS, Windows, and Linux?

Yes, the Pulp WebView bridge supports macOS, Windows, and Linux. Platform-specific requirements ensure native message handlers and AssetManager-based embedded resources function correctly across all three operating systems.

Why are my WebView editor features and CSS not loading correctly?

WebView editor features and CSS fail to load correctly when Monaco worker URLs are misconfigured or worker file handling is improper. You must use an ESM bundling workflow that correctly points Monaco worker URLs to resolve these loading issues.