PHPackages                             oneduo/nova-file-manager - 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. oneduo/nova-file-manager

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

oneduo/nova-file-manager
========================

A handy file manager tool for Laravel Nova

v1.0.0(10mo ago)157350.3k↓11.7%47[10 issues](https://github.com/oneduo/nova-file-manager/issues)[18 PRs](https://github.com/oneduo/nova-file-manager/pulls)2MITPHPPHP ^8.0CI passing

Since Jun 20Pushed 6mo ago3 watchersCompare

[ Source](https://github.com/oneduo/nova-file-manager)[ Packagist](https://packagist.org/packages/oneduo/nova-file-manager)[ Docs](https://github.com/oneduo/nova-file-manager)[ GitHub Sponsors](https://github.com/oneduo)[ RSS](/packages/oneduo-nova-file-manager/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (18)Versions (76)Used By (2)

[![](./docs/images/banner.png)](./docs/images/banner.png)

[![](./docs/images/documentation.png)](https://oneduo.github.io/nova-file-manager/)

[![](./docs/images/support.png)](https://novapackages.com/packages/oneduo/nova-file-manager)

Nova File Manager
=================

[](#nova-file-manager)

[![Status](https://camo.githubusercontent.com/263f3694f42afc27e06a1ff829cd63884893b55624e13a16893dd0a3ba772b94/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d6163746976652d737563636573732e737667)](https://camo.githubusercontent.com/263f3694f42afc27e06a1ff829cd63884893b55624e13a16893dd0a3ba772b94/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d6163746976652d737563636573732e737667)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](/LICENSE)[![PHP](https://camo.githubusercontent.com/7914866fcee2a09d79c8a613a49b05e8f916cb5f8a0fbcbecb18b3cc9419a0c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382d626c75652e737667)](https://camo.githubusercontent.com/7914866fcee2a09d79c8a613a49b05e8f916cb5f8a0fbcbecb18b3cc9419a0c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382d626c75652e737667)[![Laravel Nova](https://camo.githubusercontent.com/f9d5ab59da6ccc52e11ac28d1f3ac1420726e3cab9dbe67b792aea6b660f2214/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2532466e6f76612d342d6379616e2e737667)](https://camo.githubusercontent.com/f9d5ab59da6ccc52e11ac28d1f3ac1420726e3cab9dbe67b792aea6b660f2214/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2532466e6f76612d342d6379616e2e737667)[![Latest Version on Packagist](https://camo.githubusercontent.com/ade934dcd20f83ca276c1dac6e9eb94b7b4426d64b2610a2edbd687e1c4928b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6e6564756f2f6e6f76612d66696c652d6d616e616765722e737667)](https://packagist.org/packages/oneduo/nova-file-manager)[![Total Downloads](https://camo.githubusercontent.com/996338827dfa07684e47c324af99202336f02e9afa84e967754983030bd8c44c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6262732d6c61622f6e6f76612d66696c652d6d616e616765722e737667)](https://packagist.org/packages/bbs-lab/nova-file-manager)[![Downloads](https://camo.githubusercontent.com/476ec8f35f539495a70fed828b05d69198694a6efdc4c5b8060120e52d5ea523/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6e6564756f2f6e6f76612d66696c652d6d616e616765722e737667)](https://packagist.org/packages/oneduo/nova-file-manager)[![Run tests](https://github.com/oneduo/nova-file-manager/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/oneduo/nova-file-manager/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/47fe948a6b95b25f2cb2697f1c795ff750471f63ad59c6303fc04b1b6b792fde/68747470733a2f2f636f6465636f762e696f2f6769746875622f6f6e6564756f2f6e6f76612d66696c652d6d616e616765722f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d4c364c58464241394a58)](https://codecov.io/github/oneduo/nova-file-manager)

---

A file manager tool and field for Laravel Nova. Beautifully designed, and customizable, this tool will provide a plug'n'play solution for your file management needs.

**Features :**

⚡️ Blazing fast
📦️ Laravel Nova 4 compatible
💅 Built with Tailwindcss 3, Vue 3 and Pinia
🪨 Rock solid codebase built with Typescript
💽 Multi disk and filesystem support
🧩 Supports chunk and resumable uploads
🔧 Various customization and configuration options
🔍 A performant local search feature with Spotlight
🤹‍ Can save multiple assets from the same field
🔐 Access control and authorization gates
✂️ Built-in crop tool and image editor
📇 Built-in PDF viewer
🗂️ Drag and drop upload, with entire folder upload support
🗃️ Supports unzipping files
🚩 Onboarding tour for new users

Table of Contents
-----------------

[](#table-of-contents)

- [Getting Started](#getting_started)
    - [Prerequisites](#prerequisites)
    - [Installing](#installing)
    - [Configuration](#configuration)
- [Usage](#usage)
- [Configuration](#configuration-file)
- [Authors](#authors)
- [Screenshots](#screenshots)
- [Changelog](#changelog)
- [Security](#security)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)

Getting Started
-----------------------------------------------------------

[](#getting-started-)

### Prerequisites

[](#prerequisites)

This package requires the following :

- PHP 8.0 or higher
- Laravel Nova 4

> **Note** If you plan on using this package with an S3 bucket, be mindful to follow the instructions for [setting up an S3 storage disk. ](https://laravel.com/docs/9.x/filesystem#s3-driver-configuration)

### Installing

[](#installing)

To get started, you will need to install the following dependencies :

```
composer require oneduo/nova-file-manager

```

That's it, you're ready to go!

### Configuration

[](#configuration)

You may publish the package's configuration by running the following command :

```
php artisan vendor:publish --tag="nova-file-manager-config"
```

> **Note** You can find details about the configuration options in the [configuration file section](#configuration-file).

Usage
---------------------------------------

[](#usage-)

To get yourself started, you need to add the following tool to your `NovaServiceProvider.php`

```
// NovaServiceProvider.php

use Oneduo\NovaFileManager\NovaFileManager;

class NovaServiceProvider extends NovaApplicationServiceProvider
{
    // ...

    public function tools(): array
    {
        return [
            // ... any other tools
            NovaFileManager::make(),
        ];
    }
}
```

Now that the tool is registered, if you go back to your Nova dashboard, you should see a new navigation entry labeled " File Manager".

Once you've added the tool, you can start using it.

Go ahead and add a `FileManager` field to your Nova resource.

```
// app/Nova/User.php

use Oneduo\NovaFileManager\FileManager;

class User extends Resource
{
    // ...

    public function fields(NovaRequest $request): array
    {
        return [
            // ... any other fields
            FileManager::make(__('Avatar'), 'avatar'),
        ];
    }
}
```

You have now successfully added a File Manager field to your resource.

Configuration file
-----------------------------------------------------------------

[](#configuration-file-)

KeyDescriptionTypeDefaultNotes`default_disk`The default disk used by the package`string``public`The default disk must be defined in your `filesystems.php` config`available_disks`Provides a list of available disks to be used by the package`string[]`-`show_hidden_files`Toggles whether or not to show files and folders that start with a "dot"`bool``false``human_readable_size`When set to true, the package will display file sizes in a more friendly readable format`bool``true``human_readable_datetime`When set to true, the package will display dates with `diffForHumans()``bool``true``file_analysis.enable`When set to true, the package will use getID3 to parse metadata from the files`bool``true``file_analysis.cache.enable`When set to true, the package will cache the file analysis result`bool``true``file_analysis.cache.ttl_in_seconds`TTL for analysis caching in seconds`int``86400``url_signing.enabled`When set to true, all the file urls will be signed`bool``false``url_signing.unit`Defines the unit for the expiration time`string``minutes`The expiration time must not exceed 1 week`url_signing.value`Defines the value for the expiration time`int``10`For a full list of updated configuration options, please refer to the full documentation at

Authors
-------------------------------------------

[](#authors-)

- [Charaf Rezrazi](https://github.com/rezrazi)
- [Mikaël Popowicz](https://github.com/mikaelpopowicz)

See also the list of [contributors](https://github.com/oneduo/nova-file-manager/contributors) who participated in this project.

Screenshots
---------------------------------------------------

[](#screenshots-)

You can find more screenshots here .

Changelog
---------

[](#changelog)

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

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

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

[](#contributing)

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

Credits
-------

[](#credits)

- [getID3() by James Heinrich](https://github.com/JamesHeinrich/getID3)
- [Laravel Chunk Upload](https://github.com/pionl/laravel-chunk-upload)

License
-------

[](#license)

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

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance59

Moderate activity, may be stable

Popularity55

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~20 days

Recently: every ~0 days

Total

56

Last Release

323d ago

Major Versions

v0.16.0 → v1.0.02025-06-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/8cf9fd13f4d32603791fb5ba1796ba8f04c843b99dfa35310ed1499806adc333?d=identicon)[mikaelpopowicz](/maintainers/mikaelpopowicz)

![](https://www.gravatar.com/avatar/fab6b46363863a2d820c53377e8941ede51db95f6680b9bf506ad192652300c8?d=identicon)[Rezrazi](/maintainers/Rezrazi)

---

Top Contributors

[![mikaelpopowicz](https://avatars.githubusercontent.com/u/5689944?v=4)](https://github.com/mikaelpopowicz "mikaelpopowicz (294 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (201 commits)")[![crezra](https://avatars.githubusercontent.com/u/81156495?v=4)](https://github.com/crezra "crezra (175 commits)")[![Rezrazi](https://avatars.githubusercontent.com/u/2086576?v=4)](https://github.com/Rezrazi "Rezrazi (165 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (10 commits)")[![miagg](https://avatars.githubusercontent.com/u/6439071?v=4)](https://github.com/miagg "miagg (6 commits)")[![ngochangtf](https://avatars.githubusercontent.com/u/18624860?v=4)](https://github.com/ngochangtf "ngochangtf (5 commits)")[![milewski](https://avatars.githubusercontent.com/u/2874967?v=4)](https://github.com/milewski "milewski (2 commits)")[![vesper8](https://avatars.githubusercontent.com/u/816028?v=4)](https://github.com/vesper8 "vesper8 (1 commits)")[![Human018](https://avatars.githubusercontent.com/u/8413094?v=4)](https://github.com/Human018 "Human018 (1 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (1 commits)")[![jan-tricks](https://avatars.githubusercontent.com/u/113358501?v=4)](https://github.com/jan-tricks "jan-tricks (1 commits)")[![Joemires](https://avatars.githubusercontent.com/u/34143261?v=4)](https://github.com/Joemires "Joemires (1 commits)")[![pblaravel](https://avatars.githubusercontent.com/u/10829306?v=4)](https://github.com/pblaravel "pblaravel (1 commits)")[![Tarpsvo](https://avatars.githubusercontent.com/u/2018660?v=4)](https://github.com/Tarpsvo "Tarpsvo (1 commits)")

---

Tags

filelaravelmanagernovafilesystemlaraveltoolfilemanagermultiplenovadisks

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/oneduo-nova-file-manager/health.svg)

```
[![Health](https://phpackages.com/badges/oneduo-nova-file-manager/health.svg)](https://phpackages.com/packages/oneduo-nova-file-manager)
```

###  Alternatives

[bbs-lab/nova-file-manager

A handy file manager tool for Laravel Nova

1578.0k](/packages/bbs-lab-nova-file-manager)[digital-creative/nova-filepond

A Nova field for uploading File, Image and Video using filepond.

5568.0k1](/packages/digital-creative-nova-filepond)[itskodinger/midia

Simple Media manager for your Laravel project

1415.8k](/packages/itskodinger-midia)[stepanenko3/nova-filemanager

File manager tool for Laravel Nova

1633.5k2](/packages/stepanenko3-nova-filemanager)[bringyourownideas/laravel-backblaze

Backblaze B2 Cloud Storage for Laravel 5. Original by Paul Olthof (@hpolthof) continued by @bringyourownideas

1237.8k](/packages/bringyourownideas-laravel-backblaze)

PHPackages © 2026

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