README

A web UI for managing Laravel backups and backup schedules, built on top of spatie/laravel-backup.

Features

• Backup Management — View, create, download, and delete backups from a clean web interface
• Scheduled Backups — Create and manage backup schedules (daily, weekly, monthly)
• One-Click Backups — Run full, database-only, or files-only backups instantly
• Queue Support — Backup jobs are dispatched to your queue for non-blocking execution
• Polymorphic Tracking — Every backup records who created it
• Custom Layout Support — Use the built-in Tailwind layout or plug into your own
• Publishable Assets — Config, migrations, and views are all publishable

Installation

composer require mahmoud-mhamed/laravel-backup-browse

The package auto-discovers its service provider. No manual registration needed.

Publish Config (optional)

php artisan vendor:publish --tag=backup-browse-config

Run Migrations

php artisan migrate

Migrations are idempotent — running them twice won't cause errors.

Set Up the Scheduler

Add this to your server's crontab if you haven't already:

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

The package automatically registers its backup-browse:run-scheduled command to run every minute via Laravel's scheduler.

Configuration

After publishing, edit config/backup-browse.php:

return [
    // Middleware applied to all routes
    'middleware' => ['web', 'auth'],

    // URL prefix: yourdomain.com/backup-browse
    'route_prefix' => 'backup-browse',

    // Filesystem disk for storing backups
    'disk' => 'local',

    // Set to your app layout (e.g. 'layouts.app') or null for standalone
    'layout' => null,

    // @yield() section name in your layout
    'content_section' => 'content',

    // Queue settings (null = app defaults)
    'queue_connection' => null,
    'queue' => null,

    // Toggle which backup types are available
    'allow_full_backup' => true,
    'allow_db_only_backup' => true,
    'allow_files_only_backup' => true,
];

Usage

Web Interface

Navigate to /backup-browse in your browser.

Backups tab — View all backups with status badges, download completed backups, or delete old ones. Hit Backup Now, DB Only, or Files Only to trigger a new backup.

Schedules tab — Create, edit, and delete backup schedules. Choose from daily, weekly, or monthly frequencies. Toggle schedules on/off without deleting them.

Artisan Commands

Run all due backup schedules manually:

php artisan backup-browse:run-scheduled

Using Your Own Layout

Set the layout config to your app's layout view:

'layout' => 'layouts.app',
'content_section' => 'content',

The package views will render inside your layout's @yield('content') section. When layout is null, a standalone layout with Tailwind CSS (via CDN) is used.

Publish Views for Customization

php artisan vendor:publish --tag=backup-browse-views

Views will be copied to resources/views/vendor/backup-browse/ where you can modify them freely.

How It Works

User clicks "Backup Now"
        │
        ▼
BackupController creates a Backup record (status: pending)
        │
        ▼
CreateBackupJob is dispatched to queue
        │
        ▼
Job runs `php artisan backup:run` (spatie/laravel-backup)
        │
        ▼
Job finds the newest .zip on disk, updates Backup record
        │
        ▼
Backup status → completed (with path + size)

For scheduled backups, the backup-browse:run-scheduled command runs every minute, checks which schedules are due via cron expressions, and dispatches CreateBackupJob for each.

Database Schema

backups

backup_schedules

Testing

composer test

Or directly:

vendor/bin/phpunit

Tests use Orchestra Testbench with SQLite in-memory. No external services required.

Requirements

• PHP 8.2+
• Laravel 10.x or 11.x
• spatie/laravel-backup v9 (installed automatically)

License

MIT License. See LICENSE for details.