Repository navigation
Home
Every working day, in every country. HolidayOps merges public holidays, each country's own weekend and your company's closures into one answer, for 250 countries and 624 regions. It is a REST API, a web app, private iCal feeds, monthly email digests and signed webhooks, in English, Urdu and Arabic, built on the open-source holidays library.
Status: feature-complete across all milestones. Hosting is planned for launch; until then HolidayOps runs locally or on your own server. See docs/status.md.
| I want to | Read |
|---|---|
| Use the web app (no code) | Using HolidayOps |
| Call the API from my software | API Quick Reference |
| Receive calendar changes in my system | Webhooks |
| Run it on my machine | Developer Setup |
| Configure email, reCAPTCHA, Google sign-in | Configuration |
| Run it on a server | Self Hosting |
| Fix a setup error | Troubleshooting |
| Understand how it is built | Architecture |
| Contribute a change | Contributing |
| Know how versions are numbered | Releases and Versioning |
| Quick answers | FAQ |
This wiki is a short guide. The detailed, reviewed documentation lives in the repository and is updated in the same pull request as the code:
- README: features, setup, keys, troubleshooting
- docs/: architecture, security, SEO, deployment, design notes per milestone
- CHANGELOG: what changed, newest first
- SECURITY.md: how to report a vulnerability
If the wiki and the repository disagree, the repository is right. Please open an issue so the wiki gets fixed.