PHPackages                             jeffersongoncalves/filament-metrics-fathom - 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. [Admin Panels](/categories/admin)
4. /
5. jeffersongoncalves/filament-metrics-fathom

ActiveLibrary[Admin Panels](/categories/admin)

jeffersongoncalves/filament-metrics-fathom
==========================================

Filament plugin for Fathom Analytics metrics - dashboard widgets for pageviews, visitors, top pages, referrers, browsers, countries and devices.

v3.0.1(2mo ago)20MITPHPPHP ^8.2CI passing

Since Mar 3Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/filament-metrics-fathom)[ Packagist](https://packagist.org/packages/jeffersongoncalves/filament-metrics-fathom)[ Docs](https://github.com/jeffersongoncalves/filament-metrics-fathom)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-filament-metrics-fathom/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelog (5)Dependencies (9)Versions (8)Used By (0)

[![Filament Metrics Fathom](https://raw.githubusercontent.com/jeffersongoncalves/filament-metrics-fathom/3.x/art/jeffersongoncalves-filament-metrics-fathom.jpg)](https://raw.githubusercontent.com/jeffersongoncalves/filament-metrics-fathom/3.x/art/jeffersongoncalves-filament-metrics-fathom.jpg)

Filament Metrics Fathom
=======================

[](#filament-metrics-fathom)

[![Latest Version on Packagist](https://camo.githubusercontent.com/741ee02c549f565c6e0152bce374cecc097b417fb3450b9e1932aff305dd06d3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d6d6574726963732d666174686f6d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-metrics-fathom)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/75a3547675618029f434714e3c5617ec0798c51756c4a8698248cbafb37fe15e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d6d6574726963732d666174686f6d2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d332e78266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/filament-metrics-fathom/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3A3.x)[![Total Downloads](https://camo.githubusercontent.com/886bc135b4c753a48c16638b645ee5c93b5046f68a7fb10b173cce90c974a452/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d6d6574726963732d666174686f6d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-metrics-fathom)[![License](https://camo.githubusercontent.com/849aa88a53f5dea134bd25462984c64f00224ac2e465707658c98d7192d0f1dc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d6d6574726963732d666174686f6d2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

A [Filament](https://filamentphp.com) plugin that integrates [Fathom Analytics](https://usefathom.com) into your admin panel. Get real-time visitor counts, pageview charts, top pages, referrers, browsers, countries and device breakdowns — all from your Filament dashboard.

Features
--------

[](#features)

- Settings page to configure Fathom API credentials directly from the panel
- 7 ready-to-use dashboard widgets (stats, charts, tables)
- Real-time visitor count with automatic polling (every 30s)
- Caching built-in to respect Fathom API rate limits (10 req/min)
- Multi-language support (English and Brazilian Portuguese)
- Fully configurable: enable/disable settings page and widgets independently

Version Compatibility
---------------------

[](#version-compatibility)

PluginFilamentLaravelPHPLivewire1.x3.x10.x / 11.x8.2+3.x2.x4.x11.x+8.2+3.x**3.x****5.x****11.x+****8.2+****4.x**Requirements
------------

[](#requirements)

- PHP 8.2+
- [Filament](https://filamentphp.com) ^5.0
- [jeffersongoncalves/laravel-metrics-fathom](https://github.com/jeffersongoncalves/laravel-metrics-fathom) ^1.0
- [filament/spatie-laravel-settings-plugin](https://filamentphp.com/plugins/filament-spatie-settings) ^5.0

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

[](#installation)

You can install the package via composer:

```
composer require jeffersongoncalves/filament-metrics-fathom:"^3.0"
```

Publish and run the settings migration from the base package:

```
php artisan vendor:publish --tag="metrics-fathom-settings"
php artisan migrate
```

Setup
-----

[](#setup)

Register the plugin in your Filament panel provider:

```
use JeffersonGoncalves\Filament\MetricsFathom\FathomMetricsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(FathomMetricsPlugin::make());
}
```

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

[](#configuration)

You can enable or disable features individually:

```
FathomMetricsPlugin::make()
    ->settingsPage(false) // Disable the settings page
    ->widgets(false)      // Disable all widgets
```

Widgets
-------

[](#widgets)

The plugin provides 7 dashboard widgets:

WidgetDescriptionType**Current Visitors**Real-time visitor count with top pagesStats Overview (polls every 30s)**Pageviews Chart**Visits &amp; pageviews over the last 30 daysLine Chart**Top Pages**Most visited pages with visit/pageview countsTable**Top Referrers**Traffic sources with visit/unique countsTable**Top Browsers**Browser distributionDoughnut Chart**Top Countries**Country distribution with visit/unique countsTable**Top Devices**Device type distribution (desktop, mobile, tablet)Doughnut ChartAll widgets include:

- Automatic error handling with user-friendly messages
- "Not Configured" state when API token is missing
- Built-in caching to respect Fathom API rate limits
- Multi-language support (English and Portuguese)

Translations
------------

[](#translations)

The plugin supports English (`en`) and Brazilian Portuguese (`pt_BR`). You can publish the translations:

```
php artisan vendor:publish --tag="filament-metrics-fathom-translations"
```

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)

- [Jefferson Goncalves](https://github.com/jeffersongoncalves)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance90

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90% of commits — single point of failure

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.

###  Release Activity

Cadence

Every ~4 days

Total

8

Last Release

40d ago

Major Versions

v1.0.0 → v2.0.12026-03-04

v2.0.1 → v3.0.12026-03-04

1.x-dev → 3.x-dev2026-04-03

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

---

Tags

analyticsdashboardfathomfathom-analyticsfilamentfilament-pluginlaravellivewiremetricsphpspatie-settingswidgetslaravelMetricsdashboardanalyticswidgetsfilamentfilament-pluginjeffersongoncalvesfathomspatie-settingsfathom-analytics

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeffersongoncalves-filament-metrics-fathom/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-filament-metrics-fathom/health.svg)](https://phpackages.com/packages/jeffersongoncalves-filament-metrics-fathom)
```

###  Alternatives

[inerba/filament-db-config

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

329.1k](/packages/inerba-filament-db-config)[caresome/filament-neobrutalism-theme

A neobrutalism theme for FilamentPHP admin panels

303.2k](/packages/caresome-filament-neobrutalism-theme)[andreia/filament-ui-switcher

Add a modal with options to switch between different UI layouts and styles (colors, fonts, font sizes).

233.8k](/packages/andreia-filament-ui-switcher)[jeffersongoncalves/filament-topbar

A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strategic locations.

171.2k](/packages/jeffersongoncalves-filament-topbar)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)

PHPackages © 2026

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