This repository is a Laravel-specific wrapper library for the core Spatie Menu package. Its primary function is to provide a fluent PHP interface for generating HTML navigation menus within Laravel applications. It extends the base menu functionality by integrating Laravel's routing system, URL generation helpers, Blade view rendering, and the Gate authorization system. The architecture follows standard Laravel package conventions, utilizing a Service Provider for IoC binding and a Facade for static access. The system operates by accepting route names, controller actions, or raw URLs as input, processing them through Laravel's routing and URL helpers, and outputting rendered HTML strings. It handles edge cases such as active state detection based on the current request URL and conditional rendering based on user permissions. The codebase is tightly coupled to the Laravel ecosystem (illuminate/* packages) but maintains a clean separation between the core menu logic (in the spatie/menu dependency) and the Laravel-specific glue code. Maintenance is evidenced by recent commits and a changelog tracking support for Laravel versions 8 through 13, indicating active adaptation to framework updates. The codebase enforces strict coding standards via PHP CS Fixer and utilizes Pest for testing, ensuring consistency and reliability. It is a high-quality utility library designed for reuse in any Laravel project requiring dynamic navigation menus.
This is a production Laravel application that powers the real-time office dashboard at Spatie (dashboard.spatie.be). It displays a rotating set of screens on a wall-mounted TV, showing team member statuses, GitHub/Packagist statistics, climate data, cookie club ratings, now-playing music, Officient calendar attendance, Oh Dear uptime alerts, and product analytics from Fathom. The architecture is a monolith built on Laravel 12 with Livewire 4 for reactive components, Tailwind CSS 4 for styling, and Pusher/WebSockets for real-time updates. Key entry points are the main dashboard route (/) and webhook endpoints for now-playing songs and Oh Dear alerts. Data flows from external APIs (Fathom, GitHub, Packagist, Slack, Officient, Apple Music, Last.fm, climate sensors, Cookie Club) into database-backed tile stores, which are polled by Livewire components. The system includes a screen scheduler with conditional visibility, a weekplanning overlay, and a deploy-status endpoint for automatic page reloads. The codebase is well-structured, follows Laravel conventions, and includes comprehensive tests. While the dashboard is tailored to Spatie's internal use, many components (Fathom analytics service, forecast calculator, path normalizer, screen availability checker, weekplanning logic) are cleanly abstracted and could be reused in other dashboard or analytics projects.
This repository is a Laravel package (library) that extends the native Illuminate\Support\Collection with over 50 additional macros, such as `chunkBy`, `transpose`, `validate`, `weightedRandom`, and a `try`/`catch` proxy. It is built and maintained by Spatie and is one of the most popular collection macro libraries in the Laravel ecosystem. The architecture is straightforward: a service provider (`CollectionMacroServiceProvider`) registers each macro as a closure on the Collection class at boot time. Each macro is defined as a separate invokable class in the `src/Macros/` directory, making the codebase modular and easy to test. There is no persistent state, database, or external service integration; the package operates purely in-memory on Collection objects. The primary entry point is the service provider auto-discovered by Laravel's package discovery. External dependencies are minimal (`illuminate/support` for the base Collection class, and optionally `amphp/parallel-functions` for the `parallelMap` macro). The code exhibits high craftsmanship: macros are concise, well-documented with docblocks, and each has dedicated Pest tests. Notable patterns include the `CatchableCollectionProxy` helper, which implements a fluent try/catch mechanism on collections using reflection for exception type matching, and the `WeightedRandom` macro with a clean weighted selection algorithm. The codebase is actively maintained, supporting Laravel 12 and 13 with PHP 8.2-8.5, and shows no signs of technical drift. It is not an application or service; it is a reusable library that can be dropped into any Laravel project to enrich collection operations.
This is a Laravel package that generates RSS, Atom, and JSON feeds for Laravel applications. It provides a configuration-driven approach where developers define feed sources (models or repositories), and the package handles route registration, item resolution, and format-specific rendering. The architecture follows Laravel package conventions with a service provider, controller-based endpoints, and Blade view templates for output generation. The package supports multiple feed formats (RSS 2.0, Atom 1.0, JSON Feed 1.1) with proper MIME type handling and W3C-compliant XML output. It includes a fluent builder pattern for FeedItem construction, validation of required fields, and a Blade component for automatically generating feed link tags in HTML pages. The codebase demonstrates solid Laravel package engineering with comprehensive test coverage using Pest and snapshot testing.