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

ActiveLibrary[File &amp; 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(3mo ago)017↓50%1MITPHPPHP ^8.4

Since Apr 21Pushed 3mo 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 3w ago

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

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

36

—

LowBetter than 79% of packages

Maintenance82

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community8

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

94d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12434217?v=4)[Ahmet Özrahat](/maintainers/ahmetozrahat)[@ahmetozrahat](https://github.com/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.

1.0k3.2M246](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.8k](/packages/rawilk-profile-filament-plugin)[slimani/filament-media-manager

A media manager plugin for Filament.

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

PHPackages © 2026

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