arts/github-release-browser

Reusable GitHub release browser with PHP backend & React frontend

v1.0.0 2025-11-04 14:49 UTC

Requires

• php: >=7.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^1.1.2
• phpstan/phpstan: 2.1.x-dev
• squizlabs/php_codesniffer: 3.x-dev
• szepeviktor/phpstan-wordpress: 2.x-dev
• wp-coding-standards/wpcs: ^3.0

GPL-3.0-or-later

README

A reusable GitHub release browser package with PHP backend and React frontend.

Installation

Composer

composer require arts/github-release-browser

NPM

npm install @arts/github-release-browser

Usage

PHP

use Arts\GH\ReleaseBrowser\Browser;

$browser = new Browser([
    'cache_prefix' => 'my_app_',
    'github_token' => 'your_actual_github_token_here',  // Your GitHub personal access token
    'protocol' => 'my-app://',
    'action_prefix' => 'my_app',  // Optional: default is 'github_release_browser'
]);

// Register modal integration for WordPress media library
$browser->register_modal_integration();

TypeScript/React

import { BrowserApp } from '@arts/github-release-browser';

<BrowserApp 
  config={{
    apiUrl: '/wp-admin/admin-ajax.php',
    nonce: 'your_nonce',
    actionPrefix: 'my_app',
    protocol: 'my-app://',
    onSelectAsset: (asset) => {
      console.log('Selected asset:', asset);
    }
  }}
/>

Development

# Install dependencies
npm install

# Development build
npm run dev

# Production build
npm run build

License

GPL-3.0-or-later