Implement Plugin Marketplace with Dynamic Loading and React Native UI

[Copilot]

This PR adds a comprehensive plugin marketplace system to the LED matrix project, enabling users to discover, install, and manage plugins through a beautiful React Native interface with secure backend infrastructure.

Overview

The plugin marketplace provides a GitHub-based plugin distribution system with cryptographic verification, dynamic loading capabilities, and a responsive mobile/web interface. Users can browse plugins by category, search by keywords, and install/uninstall plugins with real-time progress tracking.

Key Features

🔒 Secure Backend Infrastructure

• SHA512 Verification: All plugin binaries are cryptographically verified before installation
• Memory-Safe Loading: Proper dlopen/dlclose management with exception handling and cleanup
• RESTful API: 12 comprehensive endpoints for plugin management operations
• Marketplace Client: Async download client with progress tracking and caching

🎨 Beautiful React Native Frontend

• Responsive Design: Works seamlessly across mobile, tablet, and web platforms
• Search & Filtering: Real-time search with category-based filtering
• Plugin Cards: Rich metadata display with preview images, descriptions, and scene listings
• Status Tracking: Live installation progress with visual indicators

⚡ Dynamic Plugin Management

• Hot Loading: Install/uninstall plugins without matrix restart
• Progress Monitoring: Real-time status updates during installation
• Version Management: Support for plugin updates and version checking
• Dependency Resolution: Framework for handling plugin dependencies

Architecture

Marketplace Index Structure

Plugins are cataloged in a centralized JSON index hosted on GitHub:

{
  "version": "1.0",
  "plugins": [
    {
      "id": "example-scenes",
      "name": "Example Scenes",
      "description": "Basic example scenes for LED matrix",
      "version": "1.0.0",
      "author": "LED Matrix Team",
      "tags": ["examples", "basic", "demo"],
      "scenes": [{"name": "Color Pulse", "description": "Smooth pulsing effect"}],
      "releases": {
        "1.0.0": {
          "matrix": {
            "url": "https://github.com/repo/releases/download/v1.0.0/plugin.so",
            "sha512": "abc123...",
            "size": 65536
          }
        }
      }
    }
  ]
}

API Endpoints

• GET /marketplace/index - Retrieve marketplace catalog
• POST /marketplace/install - Install plugin with verification
• GET /marketplace/status/{id} - Check installation status
• POST /marketplace/load - Dynamic plugin loading
• And 8 additional endpoints for complete plugin lifecycle management

Security Model

1. Download Verification: Every plugin binary includes SHA512 hash verification
2. Memory Safety: Comprehensive cleanup prevents memory leaks during plugin operations
3. Exception Handling: Robust error handling throughout the plugin lifecycle
4. Safe Unloading: Proper destruction of plugin objects and library handles

Implementation Details

Backend Components

• MarketplaceClient: Handles plugin downloads, verification, and caching
• PluginManager Extensions: Added dynamic load/unload with memory safety
• REST API Routes: Complete marketplace endpoint implementation
• JSON Serialization: Custom serialization for complex types with std::optional

Frontend Components

• Marketplace Screen: Main browsing interface with search and filters
• PluginCard: Rich plugin display with installation controls
• Status Indicators: Real-time progress and status visualization
• Navigation Integration: Seamless integration into existing app structure

Files Added/Modified

• shared/common/marketplace/ - Core marketplace client implementation
• src_matrix/server/marketplace_routes.cpp - REST API endpoints
• react-native/app/marketplace.tsx - Main marketplace screen
• react-native/components/marketplace/ - Plugin UI components
• docs/MARKETPLACE.md - Comprehensive documentation
• docs/MARKETPLACE_API.md - API reference documentation

Usage Example

Users can now:

1. Navigate to the marketplace from the main screen
2. Browse plugins by category or search by keywords
3. View detailed plugin information including scenes and compatibility
4. Install plugins with one tap and monitor progress
5. Enable/disable or uninstall plugins as needed

The system automatically handles binary downloads, hash verification, and dynamic loading without requiring matrix restarts.

Testing

The implementation has been validated with:

• Successful compilation and build of the emulator
• Plugin loading/unloading functionality
• API endpoint testing
• React Native UI component functionality
• Memory safety verification during plugin operations

This marketplace system provides a secure, user-friendly foundation for extending the LED matrix ecosystem with community-developed plugins.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[CLAassistant]

All committers have signed the CLA.