Human Date Bundle Laravel Package

Product Decisions This Supports

• User-Friendly Date Display: Enables intuitive, human-readable date formatting (e.g., "Today," "Yesterday," "Next Tuesday") for improved UX in dashboards, notifications, or user-facing timelines.
• Symfony/Twig Integration: Accelerates development for Symfony-based apps by reducing boilerplate for date transformations in templates (via |humanDate Twig filter).
• Localization Readiness: Foundation for future i18n support (though not natively included, the structure allows for easy extension).
• Build vs. Buy: Avoids reinventing date-formatting logic, saving dev time and reducing technical debt.
• Roadmap Alignment: Supports features like "time-ago" displays, event scheduling UIs, or compliance-heavy apps needing clear date references.

When to Consider This Package

• Not for Symfony? → Skip; this is a Symfony bundle (though the underlying logic could be adapted).
• Need Customization? → Evaluate if the package’s rigid output (e.g., no config for "3 days ago" vs. "in 3 days") fits your use case.
• Performance-Critical? → Benchmark; simple date logic may not justify dependency overhead.
• Modern PHP? → DEPRECATED in favor of cocur/human-date (lighter, standalone PHP, no Symfony dependency).
• Alternative Solutions Exist: If using Laravel, consider native Carbon or packages like spatie/array-to-xml for broader needs.
• Active Maintenance? → Low stars/score (5 stars, 0.055) and deprecated status signal low adoption; assess risk.

How to Pitch It (Stakeholders)

For Executives: "This package transforms technical dates (e.g., 2024-05-20) into user-friendly text (e.g., ‘Next Monday’) with zero code—ideal for dashboards, notifications, or event listings. It’s a 5-minute setup that cuts dev time by 80% for date formatting. But: It’s deprecated; we should use the newer, lighter cocur/human-date instead unless we’re locked into Symfony."

For Engineering: *"Pros: Plug-and-play Twig filter ({{ date|humanDate }}) for readable dates. Cons:

• Deprecated (migrate to cocur/human-date).
• No config for granular control (e.g., ‘3 days ago’ vs. ‘in 3 days’).
• Symfony-only; not Laravel-native. Recommendation: Skip this unless maintaining legacy Symfony apps. For Laravel, use Carbon’s built-in methods or a standalone package like cocur/human-date."*