GitHub App

The Onsynk GitHub App syncs your GitHub repositories to your organization registry automatically whenever you push a new tag.

Installing the App

1. Go to your organization's Filament dashboard
2. Navigate to Installations → GitHub App
3. Click Install GitHub App — you will be redirected to GitHub
4. Select which repositories to grant access to
5. Confirm the installation

Once installed, Onsynk will receive webhook events for your selected repositories.

How Syncing Works

When you push a git tag to a connected repository, Onsynk:

1. Receives a push webhook from GitHub
2. Downloads a ZIP archive of the tag
3. Creates or updates the package version in your registry
4. The package becomes available to licensed users immediately

Tag Format

Onsynk recognizes standard SemVer tags:

v1.0.0
v1.2.3
1.0.0

Permissions Required

The GitHub App requests the following permissions:

| Permission | Reason | |------------|--------| | contents: read | Download release archives | | metadata: read | List repositories | | webhooks | Receive push/tag events |

Uninstalling

To revoke access, go to GitHub → Settings → Applications → Installed GitHub Apps and remove Onsynk. Existing package versions will remain in your registry.