nuewire / filesystem
Encrypted, file-based filesystem settings for Laravel with a single Livewire component.
Maintainers
Requires
- php: ^8.2
- illuminate/auth: ^11.0|^12.0|^13.0
- illuminate/contracts: ^11.0|^12.0|^13.0
- illuminate/encryption: ^11.0|^12.0|^13.0
- illuminate/filesystem: ^11.0|^12.0|^13.0
- illuminate/support: ^11.0|^12.0|^13.0
- illuminate/translation: ^11.0|^12.0|^13.0
- illuminate/validation: ^11.0|^12.0|^13.0
- league/flysystem-aws-s3-v3: ^3.0
- livewire/livewire: ^3.6|^4.0.3
- nuewire/support: ^1.0
- psr/log: ^1.1|^2.0|^3.0
Requires (Dev)
- orchestra/testbench: ^9.0|^10.0|^11.0
- phpunit/phpunit: ^11.0|^12.0
Suggests
- nuewire/platform: Adds Storage under Settings > Configuration in the Nuewire admin navigation.
README
Filesystem settings for Laravel and Livewire.
Install
composer require nuewire/filesystem php artisan optimize:clear
Component
<livewire:nuewire-filesystem />
With nuewire/platform 2, the page appears under Settings → Configuration → Storage at /admin/settings/storage.
Storage
Settings are encrypted at:
storage/app/private/.nuewire/filesystem.json
Available disks:
nuewire
nuewire-local
nuewire-s3
nuewire-bunnycdn
nuewire always points to the active provider.
Storage::disk('nuewire')->put('files/example.txt', $contents);
The selected disk can become Laravel's default. Calls with an explicit disk such as Storage::disk('public') are not changed.
Base directory
Set a relative directory such as:
my-app/media
A write to avatars/user.jpg is stored below my-app/media/avatars/user.jpg.
Local storage
php artisan storage:link
Access
The component requires authentication by default.
NUEWIRE_FILESYSTEM_GATE=manage-filesystem-settings
Publish
php artisan vendor:publish --tag=nuewire-filesystem-config php artisan vendor:publish --tag=nuewire-filesystem-views php artisan vendor:publish --tag=nuewire-filesystem-translations
Config path:
config/nuewire/filesystem.php
Restart queue or Octane workers after changing providers.