[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77W7GRD2QK9D5N9VT0N8AQ2":3,"skill-same:01M77W7GRD2QK9D5N9VT0N8AQ2":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M77W7GRD2QK9D5N9VT0N8AQ2","juce-webview-windows",null,"Quick-start guide for building JUCE 8 audio plugins with WebView2 UIs on Windows. Covers essential setup, critical member ordering, and step-by-step implementation workflow.","johnson-cooper\u002Fsolara","johnson-cooper","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F129237833?v=4","01M77W77NPX34PNKYKJGW9GHE8","Cooper Johnson","01M77W77PE71KVTKQCGJYV7Z0X",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.agent\u002Fskills\u002Fskill_design_webview\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: juce-webview-windows\ndescription: Quick-start guide for building JUCE 8 audio plugins with WebView2 UIs on Windows. Covers essential setup, critical member ordering, and step-by-step implementation workflow.\n---\n\n# JUCE 8 WebView Plugin - Quick Start Guide\n\n**Platform:** Windows 11 | JUCE 8 | WebView2 | CMake\n\n---\n\n## 🎯 Quick Overview\n\nBuild audio plugin UIs using modern web technologies (HTML\u002FCSS\u002FJavaScript) instead of C++ JUCE components.\n\n**Benefits:**\n- Fast iteration with hot reloading\n- Use familiar web frameworks (React, Vue, or vanilla JS)\n- Modern UI capabilities (CSS animations, flexbox, gradients)\n- Team-friendly (frontend devs can work without C++ knowledge)\n- GPU acceleration via WebGL\n\n**Trade-offs:**\n- ~100MB additional memory footprint\n- Windows 11 WebView2 dependency\n- Different performance characteristics than native C++\n\n---\n\n## 🔴 CRITICAL: Member Declaration Order (PREVENTS DAW CRASHES)\n\n**⚠️ #1 CAUSE OF WEBVIEW PLUGIN CRASHES - MUST FOLLOW**\n\n### The Rule\n\nC++ destroys members in **REVERSE order of declaration**. WebView references relays, so relays must be declared FIRST to be destroyed LAST.\n\n### Correct Pattern (PluginEditor.h)\n\n```cpp\nprivate:\n    YourAudioProcessor& audioProcessor;\n\n    \u002F\u002F ═══════════════════════════════════════════════════════════════\n    \u002F\u002F CRITICAL: Destruction Order = Reverse of Declaration\n    \u002F\u002F Order: Relays → WebView → Attachments\n    \u002F\u002F ═══════════════════════════════════════════════════════════════\n\n    \u002F\u002F 1. RELAYS FIRST (destroyed last)\n    juce::WebSliderRelay gainRelay { \"GAIN\" };\n    juce::WebSliderRelay frequencyRelay { \"FREQUENCY\" };\n\n    \u002F\u002F 2. WEBVIEW SECOND (destroyed middle)\n    std::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\n\n    \u002F\u002F 3. ATTACHMENTS LAST (destroyed first)\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> gainAttachment;\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> frequencyAttachment;\n```\n\n**Wrong Order → DAW Crash on Unload**\n\nSee: [`..agent\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md`](..\u002F..\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md)\n\n---\n\n## 📋 Step-by-Step Implementation\n\n### Step 1: Create Web UI Files\n\n```\nplugins\u002FYourPlugin\u002F\n└── Source\u002F\n    └── ui\u002F\n        └── public\u002F\n            ├── index.html\n            └── js\u002F\n                └── index.js\n```\n\n### Step 2: Write index.html\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml lang=\"en\">\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Ctitle>My Plugin\u003C\u002Ftitle>\n  \u003Cscript type=\"module\" src=\"js\u002Findex.js\">\u003C\u002Fscript>\n  \u003Cstyle>\n    body {\n      margin: 0;\n      padding: 20px;\n      background: #1a1a2e;\n      color: #e0e0e0;\n      font-family: system-ui, sans-serif;\n    }\n    input[type=\"range\"] { width: 100%; }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Ch1>My Plugin\u003C\u002Fh1>\n  \u003Cdiv>\n    \u003Clabel for=\"gainSlider\">Gain\u003C\u002Flabel>\n    \u003Cinput type=\"range\" id=\"gainSlider\" min=\"0\" max=\"1\" step=\"0.01\" value=\"0.5\">\n    \u003Cspan id=\"gainValue\">0.5\u003C\u002Fspan>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### Step 3: Write index.js\n\n```javascript\nimport * as Juce from \".\u002Fjuce\u002Findex.js\";\n\ndocument.addEventListener(\"DOMContentLoaded\", () => {\n    \u002F\u002F Get parameter state from C++\n    const gainState = Juce.getSliderState(\"GAIN\");\n\n    const gainSlider = document.getElementById(\"gainSlider\");\n    const gainValue = document.getElementById(\"gainValue\");\n\n    \u002F\u002F User interaction → Update C++\n    gainSlider.addEventListener(\"mousedown\", () => gainState.sliderDragStarted());\n    gainSlider.addEventListener(\"mouseup\", () => gainState.sliderDragEnded());\n    gainSlider.addEventListener(\"input\", () => {\n        gainState.setNormalisedValue(gainSlider.value);\n        gainValue.textContent = gainSlider.value;\n    });\n\n    \u002F\u002F C++ automation → Update UI\n    gainState.valueChangedEvent.addListener(() => {\n        const value = gainState.getNormalisedValue();\n        gainSlider.value = value;\n        gainValue.textContent = value.toFixed(2);\n    });\n});\n```\n\n### Step 4: Configure CMakeLists.txt\n\n```cmake\n# Embed web files into binary\njuce_add_binary_data(YourPlugin_WebUI\n    SOURCES\n        Source\u002Fui\u002Fpublic\u002Findex.html\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Findex.js\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Fjuce\u002Findex.js\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Fjuce\u002Fcheck_native_interop.js\n)\n\n# Plugin definition\njuce_add_plugin(YourPlugin\n    FORMATS VST3 Standalone\n    PRODUCT_NAME \"Your Plugin\"\n    NEEDS_WEBVIEW2 TRUE\n)\n\n# Link binary data\ntarget_link_libraries(YourPlugin\n    PRIVATE\n        YourPlugin_WebUI\n        juce::juce_gui_extra\n        # ... other modules\n)\n\n# WebView2 definitions\ntarget_compile_definitions(YourPlugin\n    PUBLIC\n        JUCE_WEB_BROWSER=1\n        JUCE_USE_WIN_WEBVIEW2_WITH_STATIC_LINKING=1\n)\n```\n\n### Step 5: Create ParameterIDs.hpp\n\n```cpp\n#pragma once\n\nnamespace ParameterIDs {\n    constexpr char GAIN[] = \"GAIN\";\n    constexpr char FREQUENCY[] = \"FREQUENCY\";\n}\n```\n\n### Step 6: Write PluginEditor.h\n\n```cpp\n#pragma once\n#include \u003Cjuce_gui_extra\u002Fjuce_gui_extra.h>\n#include \"PluginProcessor.h\"\n#include \"ParameterIDs.hpp\"\n\nclass YourPluginEditor : public juce::AudioProcessorEditor\n{\npublic:\n    explicit YourPluginEditor(YourAudioProcessor&);\n    ~YourPluginEditor() override;\n\n    void paint(juce::Graphics&) override;\n    void resized() override;\n\nprivate:\n    YourAudioProcessor& audioProcessor;\n\n    \u002F\u002F CRITICAL: Relays → WebView → Attachments\n    juce::WebSliderRelay gainRelay { ParameterIDs::GAIN };\n    juce::WebSliderRelay frequencyRelay { ParameterIDs::FREQUENCY };\n\n    std::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\n\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> gainAttachment;\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> frequencyAttachment;\n\n    std::optional\u003Cjuce::WebBrowserComponent::Resource> getResource(const juce::String& url);\n    static const char* getMimeForExtension(const juce::String& extension);\n    static juce::String getExtension(juce::String filename);\n\n    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (YourPluginEditor)\n};\n```\n\n### Step 7: Write PluginEditor.cpp\n\n```cpp\n#include \"PluginEditor.h\"\n#include \"BinaryData.h\"\n\nYourPluginEditor::YourPluginEditor(YourAudioProcessor& p)\n    : AudioProcessorEditor(&p), audioProcessor(p)\n{\n    setSize(600, 400);\n\n    \u002F\u002F Create WebView with relay references\n    webView = std::make_unique\u003Cjuce::WebBrowserComponent>(\n        juce::WebBrowserComponent::Options()\n            .withBackend(juce::WebBrowserComponent::Options::Backend::webview2)\n            .withWinWebView2Options(\n                juce::WebBrowserComponent::Options::WinWebView2{}\n                    .withUserDataFolder(juce::File::getSpecialLocation(\n                        juce::File::SpecialLocationType::tempDirectory)))\n            .withNativeIntegrationEnabled()\n            .withOptionsFrom(gainRelay)\n            .withOptionsFrom(frequencyRelay)\n            .withResourceProvider([this](const auto& url) {\n                return getResource(url);\n            })\n    );\n\n    addAndMakeVisible(*webView);\n\n    \u002F\u002F Create attachments (AFTER webView)\n    gainAttachment = std::make_unique\u003Cjuce::WebSliderParameterAttachment>(\n        *audioProcessor.getAPVTS().getParameter(ParameterIDs::GAIN),\n        gainRelay,\n        nullptr\n    );\n\n    frequencyAttachment = std::make_unique\u003Cjuce::WebSliderParameterAttachment>(\n        *audioProcessor.getAPVTS().getParameter(ParameterIDs::FREQUENCY),\n        frequencyRelay,\n        nullptr\n    );\n\n    \u002F\u002F Load UI\n    webView->goToURL(juce::WebBrowserComponent::getResourceProviderRoot());\n}\n\nYourPluginEditor::~YourPluginEditor() {}\n\nvoid YourPluginEditor::paint(juce::Graphics& g)\n{\n    g.fillAll(getLookAndFeel().findColour(juce::ResizableWindow::backgroundColourId));\n}\n\nvoid YourPluginEditor::resized()\n{\n    webView->setBounds(getLocalBounds());\n}\n\nstd::optional\u003Cjuce::WebBrowserComponent::Resource> YourPluginEditor::getResource(const juce::String& url)\n{\n    const auto urlToRetrieve = url == \"\u002F\" ? juce::String{ \"index.html\" }\n                                          : url.fromFirstOccurrenceOf(\"\u002F\", false, false);\n\n    \u002F\u002F Try to find resource in BinaryData\n    for (int i = 0; i \u003C BinaryData::namedResourceListSize; ++i)\n    {\n        const char* resourceName = BinaryData::namedResourceList[i];\n        const char* originalFilename = BinaryData::getNamedResourceOriginalFilename(resourceName);\n\n        if (originalFilename != nullptr && juce::String(originalFilename).endsWith(urlToRetrieve))\n        {\n            int dataSize = 0;\n            const char* data = BinaryData::getNamedResource(resourceName, dataSize);\n\n            if (data != nullptr && dataSize > 0)\n            {\n                std::vector\u003Cstd::byte> byteData((size_t)dataSize);\n                std::memcpy(byteData.data(), data, (size_t)dataSize);\n                auto mime = getMimeForExtension(getExtension(urlToRetrieve).toLowerCase());\n                return juce::WebBrowserComponent::Resource{ std::move(byteData), juce::String{ mime } };\n            }\n        }\n    }\n\n    return std::nullopt;\n}\n\nconst char* YourPluginEditor::getMimeForExtension(const juce::String& extension)\n{\n    static const std::unordered_map\u003Cjuce::String, const char*> mimeMap =\n    {\n        { { \"html\" }, \"text\u002Fhtml\" },\n        { { \"css\"  }, \"text\u002Fcss\" },\n        { { \"js\"   }, \"text\u002Fjavascript\" },\n        { { \"json\" }, \"application\u002Fjson\" },\n        { { \"png\"  }, \"image\u002Fpng\" },\n        { { \"jpg\"  }, \"image\u002Fjpeg\" },\n        { { \"svg\"  }, \"image\u002Fsvg+xml\" }\n    };\n\n    if (const auto it = mimeMap.find(extension.toLowerCase()); it != mimeMap.end())\n        return it->second;\n\n    return \"text\u002Fplain\";\n}\n\njuce::String YourPluginEditor::getExtension(juce::String filename)\n{\n    return filename.fromLastOccurrenceOf(\".\", false, false);\n}\n```\n\n### Step 8: Build\n\n```powershell\n.\\scripts\\build-and-install.ps1 -PluginName YourPlugin\n```\n\n### Step 9: Test\n\n1. Load plugin in DAW\n2. Open plugin window → UI should display\n3. Move sliders → parameters should update\n4. Automate in DAW → UI should update\n5. **Close window → should NOT crash**\n6. Unload plugin → should NOT crash\n\n---\n\n## ✅ Validation Checklist\n\nBefore considering your WebView plugin complete:\n\n### Code Structure\n- [ ] Member order: Relays → WebView → Attachments\n- [ ] Destruction order comment added to header\n- [ ] All relays are direct members (not `unique_ptr`)\n- [ ] WebView and attachments are `unique_ptr`\n\n### WebView Setup\n- [ ] `.withBackend(webview2)` specified\n- [ ] `.withWinWebView2Options(...withUserDataFolder(...))` provided\n- [ ] `.withNativeIntegrationEnabled()` included\n- [ ] All relays registered: `.withOptionsFrom(relay)` for each\n- [ ] Resource provider implemented\n- [ ] `webView->goToURL(...)` called\n\n### CMakeLists.txt\n- [ ] All web files in `juce_add_binary_data()`\n- [ ] `NEEDS_WEBVIEW2 TRUE` set\n- [ ] Binary data target linked\n- [ ] `JUCE_WEB_BROWSER=1` defined\n- [ ] `JUCE_USE_WIN_WEBVIEW2_WITH_STATIC_LINKING=1` defined\n\n### Resource Provider\n- [ ] Handles \"\u002F\" → \"index.html\" mapping\n- [ ] Iterates BinaryData when direct lookup fails\n- [ ] Correct MIME types returned\n- [ ] Returns `std::nullopt` for missing resources\n\n### JavaScript\n- [ ] Parameter IDs match C++ exactly\n- [ ] `sliderDragStarted()` \u002F `sliderDragEnded()` called\n- [ ] `valueChangedEvent.addListener()` used for automation\n\n### Testing\n- [ ] Plugin loads without errors\n- [ ] UI displays correctly\n- [ ] Parameters work (user interaction)\n- [ ] Automation works (DAW → UI updates)\n- [ ] **Window closes without crash**\n- [ ] **Plugin unloads without crash**\n- [ ] Multiple instances work\n\n---\n\n## ⚠️ Common Mistakes\n\n### ❌ Wrong Member Order\n```cpp\n\u002F\u002F WRONG - Crashes on unload!\nstd::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\njuce::WebSliderRelay relay { \"PARAM\" };\n```\n\n### ❌ Missing .withOptionsFrom()\n```cpp\n\u002F\u002F WRONG - Parameter binding won't work!\nwebView = std::make_unique\u003Cjuce::WebBrowserComponent>(\n    Options().withBackend(webview2)\n    \u002F\u002F Missing: .withOptionsFrom(gainRelay)\n);\n```\n\n### ❌ Wrong MIME Type\n```cpp\n\u002F\u002F WRONG - JS files won't execute!\nreturn Resource{ data, \"text\u002Fhtml\" }; \u002F\u002F For a .js file!\n```\n\n### ❌ Creating Attachments Before WebView\n```cpp\n\u002F\u002F WRONG - Order matters!\ngainAttachment = std::make_unique\u003C...>(...);  \u002F\u002F Too early\nwebView = std::make_unique\u003C...>(...);         \u002F\u002F Too late\n```\n\n### ❌ Not Embedding All Files\n```cmake\n# WRONG - Missing JS files!\njuce_add_binary_data(Plugin_WebUI\n    SOURCES\n        Source\u002Fui\u002Fpublic\u002Findex.html\n        # Missing: js files!\n)\n```\n\n---\n\n## 📚 Additional Resources\n\nFor detailed technical information, see the reference documents:\n\n- **[Technical Details](reference\u002Fwebview-technical-details.md)** - WebView2 internals, JUCE 8 changes, architecture\n- **[Communication Guide](reference\u002Fwebview-communication-guide.md)** - Frontend-backend events, native functions\n- **[Resource Providers](reference\u002Fwebview-resource-providers.md)** - Detailed resource serving patterns\n- **[Parameter Synchronization](reference\u002Fwebview-parameter-sync.md)** - Advanced parameter binding patterns\n- **[Troubleshooting](reference\u002Fwebview-troubleshooting.md)** - Debugging, performance, common issues\n\n---\n\n## 🔗 Related Documentation\n\n- **Troubleshooting:** `..agent\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md`\n- **Templates:** `templates\u002Fwebview\u002F`\n- **Working Examples:** `plugins\u002FAngelGrain\u002F`, `plugins\u002FTestWebView\u002F`\n- **Known Issues:** `..agent\u002Ftroubleshooting\u002Fknown-issues.yaml` (webview-001, webview-002)\n\n---\n\n**Document Version:** 2.0 (Streamlined)\n**Last Updated:** 2026-01-24\n**Status:** Production Ready\n\n","# JUCE 8 WebView Plugin - Quick Start Guide\n\n**Platform:** Windows 11 | JUCE 8 | WebView2 | CMake\n\n---\n\n## 🎯 Quick Overview\n\nBuild audio plugin UIs using modern web technologies (HTML\u002FCSS\u002FJavaScript) instead of C++ JUCE components.\n\n**Benefits:**\n- Fast iteration with hot reloading\n- Use familiar web frameworks (React, Vue, or vanilla JS)\n- Modern UI capabilities (CSS animations, flexbox, gradients)\n- Team-friendly (frontend devs can work without C++ knowledge)\n- GPU acceleration via WebGL\n\n**Trade-offs:**\n- ~100MB additional memory footprint\n- Windows 11 WebView2 dependency\n- Different performance characteristics than native C++\n\n---\n\n## 🔴 CRITICAL: Member Declaration Order (PREVENTS DAW CRASHES)\n\n**⚠️ #1 CAUSE OF WEBVIEW PLUGIN CRASHES - MUST FOLLOW**\n\n### The Rule\n\nC++ destroys members in **REVERSE order of declaration**. WebView references relays, so relays must be declared FIRST to be destroyed LAST.\n\n### Correct Pattern (PluginEditor.h)\n\n```cpp\nprivate:\n    YourAudioProcessor& audioProcessor;\n\n    \u002F\u002F ═══════════════════════════════════════════════════════════════\n    \u002F\u002F CRITICAL: Destruction Order = Reverse of Declaration\n    \u002F\u002F Order: Relays → WebView → Attachments\n    \u002F\u002F ═══════════════════════════════════════════════════════════════\n\n    \u002F\u002F 1. RELAYS FIRST (destroyed last)\n    juce::WebSliderRelay gainRelay { \"GAIN\" };\n    juce::WebSliderRelay frequencyRelay { \"FREQUENCY\" };\n\n    \u002F\u002F 2. WEBVIEW SECOND (destroyed middle)\n    std::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\n\n    \u002F\u002F 3. ATTACHMENTS LAST (destroyed first)\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> gainAttachment;\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> frequencyAttachment;\n```\n\n**Wrong Order → DAW Crash on Unload**\n\nSee: [`..agent\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md`](..\u002F..\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md)\n\n---\n\n## 📋 Step-by-Step Implementation\n\n### Step 1: Create Web UI Files\n\n```\nplugins\u002FYourPlugin\u002F\n└── Source\u002F\n    └── ui\u002F\n        └── public\u002F\n            ├── index.html\n            └── js\u002F\n                └── index.js\n```\n\n### Step 2: Write index.html\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml lang=\"en\">\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Ctitle>My Plugin\u003C\u002Ftitle>\n  \u003Cscript type=\"module\" src=\"js\u002Findex.js\">\u003C\u002Fscript>\n  \u003Cstyle>\n    body {\n      margin: 0;\n      padding: 20px;\n      background: #1a1a2e;\n      color: #e0e0e0;\n      font-family: system-ui, sans-serif;\n    }\n    input[type=\"range\"] { width: 100%; }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Ch1>My Plugin\u003C\u002Fh1>\n  \u003Cdiv>\n    \u003Clabel for=\"gainSlider\">Gain\u003C\u002Flabel>\n    \u003Cinput type=\"range\" id=\"gainSlider\" min=\"0\" max=\"1\" step=\"0.01\" value=\"0.5\">\n    \u003Cspan id=\"gainValue\">0.5\u003C\u002Fspan>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### Step 3: Write index.js\n\n```javascript\nimport * as Juce from \".\u002Fjuce\u002Findex.js\";\n\ndocument.addEventListener(\"DOMContentLoaded\", () => {\n    \u002F\u002F Get parameter state from C++\n    const gainState = Juce.getSliderState(\"GAIN\");\n\n    const gainSlider = document.getElementById(\"gainSlider\");\n    const gainValue = document.getElementById(\"gainValue\");\n\n    \u002F\u002F User interaction → Update C++\n    gainSlider.addEventListener(\"mousedown\", () => gainState.sliderDragStarted());\n    gainSlider.addEventListener(\"mouseup\", () => gainState.sliderDragEnded());\n    gainSlider.addEventListener(\"input\", () => {\n        gainState.setNormalisedValue(gainSlider.value);\n        gainValue.textContent = gainSlider.value;\n    });\n\n    \u002F\u002F C++ automation → Update UI\n    gainState.valueChangedEvent.addListener(() => {\n        const value = gainState.getNormalisedValue();\n        gainSlider.value = value;\n        gainValue.textContent = value.toFixed(2);\n    });\n});\n```\n\n### Step 4: Configure CMakeLists.txt\n\n```cmake\n# Embed web files into binary\njuce_add_binary_data(YourPlugin_WebUI\n    SOURCES\n        Source\u002Fui\u002Fpublic\u002Findex.html\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Findex.js\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Fjuce\u002Findex.js\n        Source\u002Fui\u002Fpublic\u002Fjs\u002Fjuce\u002Fcheck_native_interop.js\n)\n\n# Plugin definition\njuce_add_plugin(YourPlugin\n    FORMATS VST3 Standalone\n    PRODUCT_NAME \"Your Plugin\"\n    NEEDS_WEBVIEW2 TRUE\n)\n\n# Link binary data\ntarget_link_libraries(YourPlugin\n    PRIVATE\n        YourPlugin_WebUI\n        juce::juce_gui_extra\n        # ... other modules\n)\n\n# WebView2 definitions\ntarget_compile_definitions(YourPlugin\n    PUBLIC\n        JUCE_WEB_BROWSER=1\n        JUCE_USE_WIN_WEBVIEW2_WITH_STATIC_LINKING=1\n)\n```\n\n### Step 5: Create ParameterIDs.hpp\n\n```cpp\n#pragma once\n\nnamespace ParameterIDs {\n    constexpr char GAIN[] = \"GAIN\";\n    constexpr char FREQUENCY[] = \"FREQUENCY\";\n}\n```\n\n### Step 6: Write PluginEditor.h\n\n```cpp\n#pragma once\n#include \u003Cjuce_gui_extra\u002Fjuce_gui_extra.h>\n#include \"PluginProcessor.h\"\n#include \"ParameterIDs.hpp\"\n\nclass YourPluginEditor : public juce::AudioProcessorEditor\n{\npublic:\n    explicit YourPluginEditor(YourAudioProcessor&);\n    ~YourPluginEditor() override;\n\n    void paint(juce::Graphics&) override;\n    void resized() override;\n\nprivate:\n    YourAudioProcessor& audioProcessor;\n\n    \u002F\u002F CRITICAL: Relays → WebView → Attachments\n    juce::WebSliderRelay gainRelay { ParameterIDs::GAIN };\n    juce::WebSliderRelay frequencyRelay { ParameterIDs::FREQUENCY };\n\n    std::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\n\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> gainAttachment;\n    std::unique_ptr\u003Cjuce::WebSliderParameterAttachment> frequencyAttachment;\n\n    std::optional\u003Cjuce::WebBrowserComponent::Resource> getResource(const juce::String& url);\n    static const char* getMimeForExtension(const juce::String& extension);\n    static juce::String getExtension(juce::String filename);\n\n    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (YourPluginEditor)\n};\n```\n\n### Step 7: Write PluginEditor.cpp\n\n```cpp\n#include \"PluginEditor.h\"\n#include \"BinaryData.h\"\n\nYourPluginEditor::YourPluginEditor(YourAudioProcessor& p)\n    : AudioProcessorEditor(&p), audioProcessor(p)\n{\n    setSize(600, 400);\n\n    \u002F\u002F Create WebView with relay references\n    webView = std::make_unique\u003Cjuce::WebBrowserComponent>(\n        juce::WebBrowserComponent::Options()\n            .withBackend(juce::WebBrowserComponent::Options::Backend::webview2)\n            .withWinWebView2Options(\n                juce::WebBrowserComponent::Options::WinWebView2{}\n                    .withUserDataFolder(juce::File::getSpecialLocation(\n                        juce::File::SpecialLocationType::tempDirectory)))\n            .withNativeIntegrationEnabled()\n            .withOptionsFrom(gainRelay)\n            .withOptionsFrom(frequencyRelay)\n            .withResourceProvider([this](const auto& url) {\n                return getResource(url);\n            })\n    );\n\n    addAndMakeVisible(*webView);\n\n    \u002F\u002F Create attachments (AFTER webView)\n    gainAttachment = std::make_unique\u003Cjuce::WebSliderParameterAttachment>(\n        *audioProcessor.getAPVTS().getParameter(ParameterIDs::GAIN),\n        gainRelay,\n        nullptr\n    );\n\n    frequencyAttachment = std::make_unique\u003Cjuce::WebSliderParameterAttachment>(\n        *audioProcessor.getAPVTS().getParameter(ParameterIDs::FREQUENCY),\n        frequencyRelay,\n        nullptr\n    );\n\n    \u002F\u002F Load UI\n    webView->goToURL(juce::WebBrowserComponent::getResourceProviderRoot());\n}\n\nYourPluginEditor::~YourPluginEditor() {}\n\nvoid YourPluginEditor::paint(juce::Graphics& g)\n{\n    g.fillAll(getLookAndFeel().findColour(juce::ResizableWindow::backgroundColourId));\n}\n\nvoid YourPluginEditor::resized()\n{\n    webView->setBounds(getLocalBounds());\n}\n\nstd::optional\u003Cjuce::WebBrowserComponent::Resource> YourPluginEditor::getResource(const juce::String& url)\n{\n    const auto urlToRetrieve = url == \"\u002F\" ? juce::String{ \"index.html\" }\n                                          : url.fromFirstOccurrenceOf(\"\u002F\", false, false);\n\n    \u002F\u002F Try to find resource in BinaryData\n    for (int i = 0; i \u003C BinaryData::namedResourceListSize; ++i)\n    {\n        const char* resourceName = BinaryData::namedResourceList[i];\n        const char* originalFilename = BinaryData::getNamedResourceOriginalFilename(resourceName);\n\n        if (originalFilename != nullptr && juce::String(originalFilename).endsWith(urlToRetrieve))\n        {\n            int dataSize = 0;\n            const char* data = BinaryData::getNamedResource(resourceName, dataSize);\n\n            if (data != nullptr && dataSize > 0)\n            {\n                std::vector\u003Cstd::byte> byteData((size_t)dataSize);\n                std::memcpy(byteData.data(), data, (size_t)dataSize);\n                auto mime = getMimeForExtension(getExtension(urlToRetrieve).toLowerCase());\n                return juce::WebBrowserComponent::Resource{ std::move(byteData), juce::String{ mime } };\n            }\n        }\n    }\n\n    return std::nullopt;\n}\n\nconst char* YourPluginEditor::getMimeForExtension(const juce::String& extension)\n{\n    static const std::unordered_map\u003Cjuce::String, const char*> mimeMap =\n    {\n        { { \"html\" }, \"text\u002Fhtml\" },\n        { { \"css\"  }, \"text\u002Fcss\" },\n        { { \"js\"   }, \"text\u002Fjavascript\" },\n        { { \"json\" }, \"application\u002Fjson\" },\n        { { \"png\"  }, \"image\u002Fpng\" },\n        { { \"jpg\"  }, \"image\u002Fjpeg\" },\n        { { \"svg\"  }, \"image\u002Fsvg+xml\" }\n    };\n\n    if (const auto it = mimeMap.find(extension.toLowerCase()); it != mimeMap.end())\n        return it->second;\n\n    return \"text\u002Fplain\";\n}\n\njuce::String YourPluginEditor::getExtension(juce::String filename)\n{\n    return filename.fromLastOccurrenceOf(\".\", false, false);\n}\n```\n\n### Step 8: Build\n\n```powershell\n.\\scripts\\build-and-install.ps1 -PluginName YourPlugin\n```\n\n### Step 9: Test\n\n1. Load plugin in DAW\n2. Open plugin window → UI should display\n3. Move sliders → parameters should update\n4. Automate in DAW → UI should update\n5. **Close window → should NOT crash**\n6. Unload plugin → should NOT crash\n\n---\n\n## ✅ Validation Checklist\n\nBefore considering your WebView plugin complete:\n\n### Code Structure\n- [ ] Member order: Relays → WebView → Attachments\n- [ ] Destruction order comment added to header\n- [ ] All relays are direct members (not `unique_ptr`)\n- [ ] WebView and attachments are `unique_ptr`\n\n### WebView Setup\n- [ ] `.withBackend(webview2)` specified\n- [ ] `.withWinWebView2Options(...withUserDataFolder(...))` provided\n- [ ] `.withNativeIntegrationEnabled()` included\n- [ ] All relays registered: `.withOptionsFrom(relay)` for each\n- [ ] Resource provider implemented\n- [ ] `webView->goToURL(...)` called\n\n### CMakeLists.txt\n- [ ] All web files in `juce_add_binary_data()`\n- [ ] `NEEDS_WEBVIEW2 TRUE` set\n- [ ] Binary data target linked\n- [ ] `JUCE_WEB_BROWSER=1` defined\n- [ ] `JUCE_USE_WIN_WEBVIEW2_WITH_STATIC_LINKING=1` defined\n\n### Resource Provider\n- [ ] Handles \"\u002F\" → \"index.html\" mapping\n- [ ] Iterates BinaryData when direct lookup fails\n- [ ] Correct MIME types returned\n- [ ] Returns `std::nullopt` for missing resources\n\n### JavaScript\n- [ ] Parameter IDs match C++ exactly\n- [ ] `sliderDragStarted()` \u002F `sliderDragEnded()` called\n- [ ] `valueChangedEvent.addListener()` used for automation\n\n### Testing\n- [ ] Plugin loads without errors\n- [ ] UI displays correctly\n- [ ] Parameters work (user interaction)\n- [ ] Automation works (DAW → UI updates)\n- [ ] **Window closes without crash**\n- [ ] **Plugin unloads without crash**\n- [ ] Multiple instances work\n\n---\n\n## ⚠️ Common Mistakes\n\n### ❌ Wrong Member Order\n```cpp\n\u002F\u002F WRONG - Crashes on unload!\nstd::unique_ptr\u003Cjuce::WebBrowserComponent> webView;\njuce::WebSliderRelay relay { \"PARAM\" };\n```\n\n### ❌ Missing .withOptionsFrom()\n```cpp\n\u002F\u002F WRONG - Parameter binding won't work!\nwebView = std::make_unique\u003Cjuce::WebBrowserComponent>(\n    Options().withBackend(webview2)\n    \u002F\u002F Missing: .withOptionsFrom(gainRelay)\n);\n```\n\n### ❌ Wrong MIME Type\n```cpp\n\u002F\u002F WRONG - JS files won't execute!\nreturn Resource{ data, \"text\u002Fhtml\" }; \u002F\u002F For a .js file!\n```\n\n### ❌ Creating Attachments Before WebView\n```cpp\n\u002F\u002F WRONG - Order matters!\ngainAttachment = std::make_unique\u003C...>(...);  \u002F\u002F Too early\nwebView = std::make_unique\u003C...>(...);         \u002F\u002F Too late\n```\n\n### ❌ Not Embedding All Files\n```cmake\n# WRONG - Missing JS files!\njuce_add_binary_data(Plugin_WebUI\n    SOURCES\n        Source\u002Fui\u002Fpublic\u002Findex.html\n        # Missing: js files!\n)\n```\n\n---\n\n## 📚 Additional Resources\n\nFor detailed technical information, see the reference documents:\n\n- **[Technical Details](reference\u002Fwebview-technical-details.md)** - WebView2 internals, JUCE 8 changes, architecture\n- **[Communication Guide](reference\u002Fwebview-communication-guide.md)** - Frontend-backend events, native functions\n- **[Resource Providers](reference\u002Fwebview-resource-providers.md)** - Detailed resource serving patterns\n- **[Parameter Synchronization](reference\u002Fwebview-parameter-sync.md)** - Advanced parameter binding patterns\n- **[Troubleshooting](reference\u002Fwebview-troubleshooting.md)** - Debugging, performance, common issues\n\n---\n\n## 🔗 Related Documentation\n\n- **Troubleshooting:** `..agent\u002Ftroubleshooting\u002Fresolutions\u002Fwebview-member-order-crash.md`\n- **Templates:** `templates\u002Fwebview\u002F`\n- **Working Examples:** `plugins\u002FAngelGrain\u002F`, `plugins\u002FTestWebView\u002F`\n- **Known Issues:** `..agent\u002Ftroubleshooting\u002Fknown-issues.yaml` (webview-001, webview-002)\n\n---\n\n**Document Version:** 2.0 (Streamlined)\n**Last Updated:** 2026-01-24\n**Status:** Production Ready\n\n",{"name":5,"description":7},"main","12b9e0c7363e91ca0140b9c7f1c6c37c10d2eafb",".agent\u002Fskills\u002Fskill_design_webview","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper","2026-07-01 07:58:33",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add johnson-cooper\u002Fsolara --skill juce-webview-windows",{"tool":36,"command":37},"bunx","bunx skills add johnson-cooper\u002Fsolara --skill juce-webview-windows",{"tool":39,"command":40},"pnpm","pnpm dlx skills add johnson-cooper\u002Fsolara --skill juce-webview-windows","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.agent\u002Fskills\u002Fskill_design_webview\u002FSKILL.md",true,[44,50,54],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"KNOWN-ISSUES-AND-SOLUTIONS.md","REFERENCE","参考文档",10934,"https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.agent\u002Fskills\u002Fskill_design_webview\u002FKNOWN-ISSUES-AND-SOLUTIONS.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"SKILL_OLD.md",49306,"https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.agent\u002Fskills\u002Fskill_design_webview\u002FSKILL_OLD.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"WEBVIEW-PRODUCTION-GUIDE.md",23067,"https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.agent\u002Fskills\u002Fskill_design_webview\u002FWEBVIEW-PRODUCTION-GUIDE.md",[59,65,71,77,83,89],{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M77WA1DG7127E93ZCEJN9920","skill_troubleshooting","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_troubleshooting\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M77WA08NK9TBCTFKVHBD5Z2Q","skill_testing","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_testing\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M77W9Y67EC89BY21MYH3ZE34","skill_planning","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_planning\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M77W9TKWJN8QQWHJNNJM27NH","skill_packaging","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_packaging\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M77W9NG6DFVNY6PMPM09VHEE","skill_implementation","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_implementation\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M77W9KCB9VRE83Q6PHK6RDMK","skill_ideation","https:\u002F\u002Fgithub.com\u002Fjohnson-cooper\u002Fsolara\u002Fblob\u002Fmain\u002F.kilocode\u002Fskills\u002Fskill_ideation\u002FSKILL.md",[],[]]