zinxan / native-desktop

v0.2.0 2026-11-01 16:35 UTC

Requires

• php: ^8.4
• zinxan/native-core: ^0.2

Suggests

• nativephp/desktop: The NativePHP desktop runtime that this SDK reports for.

MIT

• laravel
• desktop
• error-tracking
• nativephp
• nativewatch

Published on Packagist.org on 2026-11-01 16:39 UTC

README

Contributing

Error tracking for NativePHP desktop apps. Errors go to NativeWatch.

composer require zinxan/native-desktop

Add the key of your NativeWatch project to .env:

NATIVEWATCH_KEY=nw_...
NATIVEWATCH_URL=https://native.watch

Send a test error:

php artisan nativewatch:test

Reportable exceptions enter a bounded on-disk outbox. NativeWatch normally sends them after the response and retains failed network deliveries for a later retry. Capture and disk work have a cost; an unwritable outbox can cause an immediate send attempt. Read the offline delivery guide for retry, capacity and permanent rejection behavior.

Before shipping, review privacy and diagnostic consent. Use the desktop installation guide to verify a real stored event from your packaged app.

Report something yourself:

use ZXN\NativeWatch\Core\Laravel\NativeWatch;
use ZXN\NativeWatch\Core\Level;

NativeWatch::addBreadcrumb('sync', 'Started the sync');
NativeWatch::captureMessage('The disk is almost full', Level::Warning);
NativeWatch::captureException($exception);

Publish the config to change sampling, scrubbing or breadcrumbs:

php artisan vendor:publish --tag=nativewatch-config