PHPackages                             afea/filament-files - 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. [File & Storage](/categories/file-storage)
4. /
5. afea/filament-files

ActiveLibrary[File & Storage](/categories/file-storage)

afea/filament-files
===================

File manager module for the Afea Filament CMS package ecosystem: uploaded files + external links, grouped and orderable.

v0.1.0(1mo ago)014↑445.5%MITPHPPHP ^8.4

Since Apr 21Pushed 1mo agoCompare

[ Source](https://github.com/AfeaSoftware/filament-files)[ Packagist](https://packagist.org/packages/afea/filament-files)[ RSS](/packages/afea-filament-files/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (12)Versions (2)Used By (0)

afea/filament-files
===================

[](#afeafilament-files)

File manager module for the Afea Filament CMS package ecosystem.

Ships:

- `File` model — unified listing of uploaded files (Spatie media) and external URLs
- `FileType` enum (`Upload` / `Link`) with label + color + icon
- Reorderable Filament v4 `FileResource` with a type-aware form (upload OR link, never both)
- `FilesPlugin` + `afea:install:files`

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

[](#installation)

```
composer require afea/filament-files
php artisan afea:install:files
```

Register in `AdminPanelProvider`:

```
->plugin(\Afea\Cms\Files\Filament\FilesPlugin::make())
```

Three common scenarios
----------------------

[](#three-common-scenarios)

### 1. Render a group of files on a Blade page

[](#1-render-a-group-of-files-on-a-blade-page)

```
use Afea\Cms\Files\Models\File;

$brochures = File::query()->active()->inGroup('brochures')->ordered()->get();

// each file resolves to either a media URL or an external link
foreach ($brochures as $file) {
    $file->url(); // string|null
}
```

### 2. Store uploads on a private disk

[](#2-store-uploads-on-a-private-disk)

```
AFEA_FILES_DISK=s3
```

The `$file->url()` helper keeps working — Spatie returns the disk's public URL. For signed/temporary URLs, call `$file->getFirstMedia('file')?->getTemporaryUrl(...)`.

### 3. Group arbitrary external links alongside uploads

[](#3-group-arbitrary-external-links-alongside-uploads)

Create `File` records with `type = link` pointing at external PDFs or Google Drive sharing links — they'll appear in the same group alongside uploaded files.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/090664afed2a3f014aa9cc4d2225925052fbc30e1995ebb9898272dc77a5b45f?d=identicon)[ahmetozrahat](/maintainers/ahmetozrahat)

---

Top Contributors

[![ahmetozrahat](https://avatars.githubusercontent.com/u/12434217?v=4)](https://github.com/ahmetozrahat "ahmetozrahat (2 commits)")

---

Tags

laravelfilescmsfilamentafea

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/afea-filament-files/health.svg)

```
[![Health](https://phpackages.com/badges/afea-filament-files/health.svg)](https://phpackages.com/packages/afea-filament-files)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[api-platform/laravel

API Platform support for Laravel

59156.3k10](/packages/api-platform-laravel)[slimani/filament-media-manager

A media manager plugin for Filament.

115.1k](/packages/slimani-filament-media-manager)

PHPackages © 2026

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