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