Relay Blob Connector Filesystem Bundle Laravel Package

Product Decisions This Supports

• Build vs. Buy: Accelerates development by leveraging an open-source filesystem-based blob storage solution, avoiding reinventing file handling logic (e.g., uploads, renaming, sharing) for Laravel/PHP applications.
• Roadmap Alignment: Enables scalable file management for projects using the Relay API Server (e.g., media libraries, document repositories, or user-generated content platforms).
• Feature Expansion: Supports future needs like:
  • Hybrid Storage: Combine filesystem storage with cloud (S3, etc.) via Relay’s modular connectors.
  • Cost Optimization: Reduce cloud storage costs for non-critical assets by storing blobs locally.
  • Offline Capabilities: Enable file operations in offline-first applications (e.g., mobile apps syncing with Laravel backend).

When to Consider This Package

• Adopt if:

  • Your Laravel app uses Relay-Blob-Bundle for blob management and needs filesystem storage (e.g., local dev, staging, or cost-sensitive production).
  • You require short-lived share links or basic file operations (upload/rename/delete) without cloud dependencies.
  • Your team prioritizes AGPL compliance (or can relicense under AGPL terms).

• Look elsewhere if:

  • You need cloud storage (AWS S3, GCS) or distributed file systems (e.g., Ceph). Use relay-blob-connector-cloud instead.
  • Your app requires advanced features (e.g., versioning, metadata indexing, or CDN integration). Consider custom development or packages like Spatie Laravel Media Library.
  • License concerns: AGPL-3.0 may conflict with proprietary software. Evaluate alternatives like MIT-licensed solutions (e.g., league/flysystem).
  • Maturity risks: Low stars/dependents suggest limited community support. Validate with the Relay ecosystem or fork for customization.

How to Pitch It (Stakeholders)

For Executives: "This package lets us store user files (e.g., documents, images) on our servers instead of the cloud, cutting storage costs while keeping the same API for file management. It’s a lightweight, open-source solution that integrates seamlessly with our existing Relay API—ideal for prototypes, staging, or cost-sensitive deployments. The trade-off? We’d need to ensure our servers have enough disk space, but it’s a fraction of the cost of cloud storage for non-critical assets."

For Engineering: *"The Relay-Blob-Filesystem-Bundle provides a drop-in filesystem connector for Relay’s blob system, handling:

• File uploads/downloads to a configurable local path.
• Rename/delete operations via Relay’s API.
• Short-lived share links (e.g., for temporary access). It’s a thin wrapper over Laravel’s filesystem, so it’s performant and easy to debug. Pros: No cloud dependencies, simple setup. Cons: No built-in redundancy or scalability—best for dev/staging or apps where files are ephemeral. Pair it with Relay’s cloud connectors later if needed."*