⚡ Executive Summary & Quick Facts
Authoritative Sourceholidays is holidays is an open-source project written in PHP: Calculate which days you don't have to work!..
“According to real-time open source telemetry recorded on GitHubRepo.cloud (as of October 2026), spatie/holidays has accumulated 407 GitHub stars and 218 forks. It is written in PHP, licensed under MIT, and ranks #11,471 globally. It is actively maintained with the latest commit recorded on Oct 26, 2026.”
| Repository | spatie/holidays ↗ |
|---|---|
| Primary Category | date |
| Language & Stack | PHP |
| Software License | MIT |
| Community Traction | ★ 407 stars · ⑂ 218 forks · #11,471 globally |
| Maintenance | ● Active (Last commit: Oct 26, 2026) · 0 open issues |
| Target Audience | Developers and engineering teams building with PHP, seeking reliable, tested, and actively maintained tooling for production workloads. |
🛡️ Repository Maintenance & Health Audit (2026)
Health Score: 97/100 · Grade A+Yes, holidays is actively maintained. Continuous telemetry recorded the last code commit on Oct 26, 2026 (4 days ago). Supported by 407 stars and 218 community forks, this repository holds a calculated health index of 97/100, reflecting very active (commits within last 14 days) and healthy issue cadence.
Star History
Add Live Star History & Verified Badges to README.md
Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.
Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.
[](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_chart)
Compact badges for your README header. Real-time stars, velocity, health audit, and rank.
[](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_badge) [](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_badge) [](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_badge) [](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_badge) [](https://githubrepo.cloud/repo/spatie/holidays?utm_source=readme_badge)
Momentum
+10
STARS · LAST 30 DAYS
1
PER DAY
#744
MOST-STARRED PHP
| Window | 7 days | 30 days | 90 days |
|---|---|---|---|
| Stars gained | +7 | +10 | +90 |
| Per day | 1 | 1 | 1 |
| Forks gained | +1 | +4 | +11 |
holidays gained 10 stars in the last 30 days, about 1 a day, and now has 407. It is about 3 years old and has averaged roughly 136 stars a year. It ranks #744 among PHP repositories and #11,471 across all languages on GitHubRepo.
Trending Record
3
DAYS ON TRENDING
#12231
BEST RANK
Oct 27, 2026
FIRST APPEARANCE
Active
STATUS TODAY
holidays has maintained a continuous presence across global trending indexes, peaking at #12231. Below is the 30-day activity profile:
💡 Overview
holidays is an open-source project written in PHP: Calculate which days you don't have to work!.
Engineered for speed, consistency, and developer ease, it solves common hurdles in date, holidays, php. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.
⚡ Key Features
Optimized execution pipeline written in PHP for predictable speed.
Zero-friction configuration with comprehensive sensible defaults out of the box.
Cross-platform runtime support across Linux, macOS, and Windows environments.
Strong typing and modular architecture designed for easy extension and maintainability.
Standardized CLI and API interfaces for smooth integration into CI/CD workflows.
Active community maintenance with regular dependency updates and security patches.
📥 Installation
$ git clone https://github.com/spatie/holidays.git
cd holidays
⚙ System Requirements
Platforms
- • macOS
- • Linux
- • Windows
Runtime & Dependencies
PHP >= 8.2 with Composer
Architecture
x86_64, ARM64 (Apple Silicon & Graviton)
🧠 How It Works
holidays coordinates its core functionality through a modular PHP pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.
🎯 Production Use Cases
Production System Integration
Embed holidays into PHP backend services to handle core application logic.
CI/CD Automated Pipelines
Run automated validation, builds, and integration suites during deployments.
Developer Tooling & Workflows
Accelerate developer onboarding with pre-configured project utilities.
Open Source Extension
Fork and customize internal modules under the repository's open MIT license.
🚀 Getting Started
Install holidays using your package manager: `git clone https://github.com/spatie/holidays.git`
Initialize your project workspace or configuration file for holidays.
Import holidays into your codebase or invoke it directly from your terminal.
Execute your test suite or run `holidays --help` to verify successful setup.
👍 Strengths
⚠️ Considerations
⇄ Alternatives & Direct Competitors
👥 Who Should Use This
Developers and engineering teams building with PHP, seeking reliable, tested, and actively maintained tooling for production workloads.
🏆 Nearby in the Rankings
spatie/holidays is currently ranked #11,471 by stars across every repository tracked on GitHubRepo. These are adjacent projects:
| Rank | Repository | Language | Stars | Action |
|---|---|---|---|---|
| #11,454 | stardomains3/oxproxion | Kotlin | ★ 408 | Compare ↗ |
| #11,454 | rustledger/rustledger | Rust | ★ 408 | Compare ↗ |
| #11,454 | nasty-project/nasty | Rust | ★ 408 | Compare ↗ |
| #11,454 | githubnext/chopin | TypeScript | ★ 408 | Compare ↗ |
| #11,454 | starling-build/starling | Swift | ★ 408 | Compare ↗ |
| #11,471 | spatie/holidays This Project | PHP | ★ 407 | |
| #11,471 | technoweenie/acts_as_versioned | Ruby | ★ 407 | Compare ↗ |
| #11,471 | github/auto-complete-element | JavaScript | ★ 407 | Compare ↗ |
| #11,471 | joreilly/MortyComposeKMM | Kotlin | ★ 407 | Compare ↗ |
| #11,471 | danharrin/livewire-rate-limiting | PHP | ★ 407 | Compare ↗ |
| #11,471 | sqdshguy/wreq-js | TypeScript | ★ 407 | Compare ↗ |
Frequently Asked Questions
What does holidays do? +
Calculate which days you don't have to work!
Is holidays actively maintained in 2026? +
Yes, holidays is actively maintained. The latest code push was recorded on Oct 26, 2026 (4 days ago). It holds a calculated Maintenance Health Score of 97/100 (A+ rating) with 407 stars and 0 open issues.
What language is holidays written in? +
The primary language is PHP. Topics include: date, holidays, php.
How many stars does holidays have? +
holidays has 407 stars and 218 forks on GitHub.
How does holidays rank among GitHub repositories? +
With 407 stars, spatie/holidays is ranked #11,471 globally across all repositories tracked on GitHubRepo and #744 among PHP projects.
What license is holidays distributed under? +
The repository reports a MIT license. Always verify the repository LICENSE file for legal terms.