PHPackages                             prodstarter/filament-forge-insights - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. prodstarter/filament-forge-insights

ActiveLibrary

prodstarter/filament-forge-insights
===================================

This is my package filament-forge-insights

00

Since Jul 21Compare

[ Source](https://github.com/prodstarter/filament-forge-insights)[ Packagist](https://packagist.org/packages/prodstarter/filament-forge-insights)[ RSS](/packages/prodstarter-filament-forge-insights/feed)WikiDiscussions Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Filament Forge Insights
=======================

[](#filament-forge-insights)

[![Latest Version on Packagist](https://camo.githubusercontent.com/84fd71799b2fc1dac2cd1f879f4ffcf0375a44b9781359811ceb041b710c2f67/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70726f64737461727465722f66696c616d656e742d666f7267652d696e7369676874732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/prodstarter/filament-forge-insights)[![Tests](https://camo.githubusercontent.com/d5f4a2736a430fc5f6772bb342415c7f1fe6e0b00e91bd1edce01d8085fa75e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70726f64737461727465722f66696c616d656e742d666f7267652d696e7369676874732f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/prodstarter/filament-forge-insights/actions/workflows/tests.yml)[![PHPStan](https://camo.githubusercontent.com/5a95a5e6dc681bb1d39765cb2d5a2b362d4a87eb4aee6da9df6104f2f4ba0c3f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70726f64737461727465722f66696c616d656e742d666f7267652d696e7369676874732f7068707374616e2e796d6c3f6272616e63683d6d61696e266c6162656c3d7068707374616e267374796c653d666c61742d737175617265)](https://github.com/prodstarter/filament-forge-insights/actions/workflows/phpstan.yml)[![Total Downloads](https://camo.githubusercontent.com/25035e060f94a0738e11dc6b9a670088997d1d01b5d6907f2c3b2054a53443cc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70726f64737461727465722f66696c616d656e742d666f7267652d696e7369676874732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/prodstarter/filament-forge-insights)

A read-only [Laravel Forge](https://forge.laravel.com) integration for Filament. Give agencies, freelancers, and internal teams a client-safe infrastructure dashboard — servers, sites, deployments, SSL, scheduled jobs, queue workers, and databases — without ever handing out real Forge access.

Connect a Forge API token once, and everything renders from live (cached) Forge data through a Saloon-based API layer. There are no write endpoints anywhere in the plugin — it cannot deploy, restart, or reconfigure anything on your servers.

Requirements
------------

[](#requirements)

- PHP 8.3+
- Laravel 11, 12, or 13
- Filament 5

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require prodstarter/filament-forge-insights
```

The plugin ships its own settings table and registers its migration automatically — just run your normal migration command after installing:

```
php artisan migrate
```

Register the plugin on a panel, in your panel provider's `panel()` method:

```
use Prodstarter\FilamentForgeInsights\FilamentForgeInsightsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FilamentForgeInsightsPlugin::make(),
        ]);
}
```

That's it — a new **Server** navigation group appears in the panel with a **Settings** page for connecting a Forge account.

### Connecting a Forge account

[](#connecting-a-forge-account)

1. Generate an API token from your [Forge account settings](https://forge.laravel.com/profile/api).
2. In the panel, go to **Server → Settings**.
3. Paste the token, pick an **Organization**, then click **Test Connection** and **Save**.

Everything else under the Server nav group (Dashboard, Servers, Sites, Deployments, SSL, Databases, Jobs, Workers) populates automatically once connected.

### Scoping to a server or site

[](#scoping-to-a-server-or-site)

Agencies often run several clients' sites on one shared Forge server. The Settings page lets you narrow what a panel shows, in addition to the Organization:

- **Server** (optional) — show only this one server instead of the whole organization.
- **Site** (optional, requires a Server) — show only this one site on that server.

When scoped down to a single site, the Dashboard, Servers, Sites, Deployments, and SSL pages narrow to match. Scheduled Jobs, Workers, and Databases are server-wide resources in Forge's API (they can't be attributed to a single site), so those pages are hidden entirely when a portal is scoped to one site among several on a shared server — this avoids surfacing another client's cron commands or database names.

Configuration
-------------

[](#configuration)

Publish the config file if you want to set connection defaults via environment variables (useful for CI or non-interactive deploys) instead of the Settings page:

```
php artisan vendor:publish --tag="filament-forge-insights-config"
```

```
return [
    'token' => env('FORGE_API_TOKEN'),
    'organization' => env('FORGE_ORGANIZATION_ID'),
    'server' => env('FORGE_SERVER_ID'),
    'site' => env('FORGE_SITE_ID'),
    'base_url' => env('FORGE_API_BASE_URL', 'https://forge.laravel.com/api'),
    'navigation_group' => 'Server',
    'cache' => [
        'servers' => 600,
        'sites' => 600,
        'deployments' => 120,
        'ssl' => 1800,
        'jobs' => 600,
        'workers' => 600,
        'databases' => 600,
    ],
];
```

Anything saved on the Settings page takes precedence over these values at runtime — the config file is a fallback, not the primary way most users will connect an account.

The plugin can also be configured fluently, which is handy for setting an agency-wide default that the Settings page can still override:

```
FilamentForgeInsightsPlugin::make()
    ->token(env('FORGE_API_TOKEN'))
    ->organization('my-organization-slug')
    ->navigationGroup('Infrastructure')
    ->cacheFor(now()->addMinutes(5));
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Stanley Ojadovwa](https://github.com/prodstarter)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

9

—

LowBetter than 0% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1219663?v=4)[Stanley Ojadovwa](/maintainers/stanwarri)[@stanwarri](https://github.com/stanwarri)

### Embed Badge

![Health badge](/badges/prodstarter-filament-forge-insights/health.svg)

```
[![Health](https://phpackages.com/badges/prodstarter-filament-forge-insights/health.svg)](https://phpackages.com/packages/prodstarter-filament-forge-insights)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
