Laravel Trash Cleaner Laravel Package

Product Decisions This Supports

• DevOps & Maintenance Efficiency: Automate cleanup of debug/log files (Clockwork, Debugbar, Telescope) to reduce manual intervention and human error in CI/CD pipelines or staging environments.
• Performance Optimization: Proactively clear compiled view caches (bootstrap/cache) and frontend build artifacts (e.g., node_modules, public/build) to free disk space and improve build speeds.
• Cost Savings: Reduce cloud storage costs (e.g., AWS S3, DigitalOcean Spaces) by eliminating stale debug files in production-like environments.
• Roadmap for "Self-Healing" Infrastructure: Integrate into scheduled tasks (e.g., Laravel Scheduler) to automate cleanup, aligning with a "set-and-forget" operational model.
• Build vs. Buy: Prefer this over custom scripts if the package’s flexibility (configurable paths, asset rebuilds) meets needs without reinventing wheel.
• Use Cases:
  • Post-deployment cleanup in CI/CD pipelines.
  • Nightly maintenance tasks for staging/production.
  • Onboarding new developers (standardized cleanup process).

When to Consider This Package

• Adopt if:

  • Your Laravel app uses Clockwork, Debugbar, or Telescope and debug files accumulate unchecked.
  • You need to clear compiled caches (views, routes) without manual php artisan optimize commands.
  • Your team rebuilds frontend assets frequently (e.g., Vue/React) and wants to prune old builds automatically.
  • You’re using Laravel Forge/Vapor and want to integrate cleanup into deployment scripts.
  • Your storage costs are impacted by unnecessary debug/log files in non-production environments.

• Look elsewhere if:

  • Your stack doesn’t use Laravel (package is Laravel-specific).
  • You need fine-grained control over file retention (e.g., keep logs for 7 days vs. delete all).
  • Your cleanup requirements are highly customized (e.g., regex-based file filtering beyond the package’s defaults).
  • You’re already using a dedicated monitoring tool (e.g., Datadog) that handles log management.

How to Pitch It (Stakeholders)

For Executives: "This package automates the cleanup of debug and log files in our Laravel apps, saving time and reducing storage costs. For example, it can clear Clockwork/Debugbar folders and rebuild frontend assets—tasks that currently require manual effort or custom scripts. By integrating this into our CI/CD pipeline, we can cut down on deployment-related maintenance by 30% and ensure our staging/production environments stay lean. It’s a low-risk, high-reward addition with minimal setup."

For Engineering: *"Laravel Trash Cleaner is a lightweight package that handles three key pain points:

1. Debug file cleanup: One command (trash:clean) wipes Clockwork, Debugbar, and Telescope files with a progress bar.
2. Cache optimization: Clears compiled views and frontend build artifacts (configurable paths).
3. Asset rebuilds: Optionally triggers npm/yarn/pnpm to refresh assets post-cleanup. It’s battle-tested (MIT license), configurable via published config, and integrates seamlessly with Laravel’s scheduler. Perfect for automating post-deploy or nightly maintenance tasks."*