kamellion-dev / laravel-checkpoint
Simple Laravel development checkpoints for databases and local filesystem disks.
Package info
github.com/Kamellion-Dev/laravel-checkpoint
pkg:composer/kamellion-dev/laravel-checkpoint
Requires
- php: ^8.1
- illuminate/console: ^10.0|^11.0|^12.0
- illuminate/contracts: ^10.0|^11.0|^12.0
- illuminate/database: ^10.0|^11.0|^12.0
- illuminate/filesystem: ^10.0|^11.0|^12.0
- illuminate/support: ^10.0|^11.0|^12.0
README
Simple Laravel development checkpoints for your database and local storage disks.
Why use it?
When you are working on a long backend flow, the slowest part is often getting the app back to a known state.
Instead of reseeding, rebuilding data manually, or replaying the same steps over and over, you can:
- save a checkpoint after setup is complete
- try a new branch of logic
- load the checkpoint and start again immediately
Think of it like save points for your Laravel development environment.
Quick start
Install the package:
composer require kamellion-dev/laravel-checkpoint
Laravel will auto-discover the service provider, so the commands become available immediately:
php artisan checkpoint:save php artisan checkpoint:load
Saved checkpoints are stored in the project's .dev-checkpoint folder.
Save a checkpoint with a comment:
php artisan checkpoint:save --comment="amazing starter point"
This saves the comment as a .comment file inside that checkpoint folder and shows it in checkpoint:list.
List recent checkpoints:
php artisan checkpoint:list
The list shows the display label and the actual folder name you can pass to checkpoint:load --name=....
Load a specific checkpoint folder by name:
php artisan checkpoint:load --name=your_checkpoint_folder
Load a checkpoint and re-run migrations when needed:
php artisan checkpoint:load --migrate
Clear all saved checkpoints:
php artisan checkpoint:clear
Get command help:
php artisan help checkpoint:save php artisan help checkpoint:list php artisan help checkpoint:load php artisan help checkpoint:clear php artisan help checkpoint:help
Package structure
This package keeps its classes inside src/ and registers them through a service provider instead of copying files into the host application's app/ directory.
src/commands/CheckpointSave.phpsrc/commands/CheckpointLoad.phpsrc/commands/CheckpointClear.phpsrc/commands/CheckpointHelp.phpsrc/commands/CheckpointList.phpsrc/services/DatabaseCheckpointService.phpsrc/LaravelCheckpointServiceProvider.php
To the consuming Laravel app, the commands behave like native Artisan commands without physically adding files under app/Console/Commands or app/Services.
