Liburin is a modern open-source API that provides highly accurate and up-to-date information about Indonesian Public Holidays and Collective Leave schedules. The project was built to offer developers a lightweight, fast, and maintenance-free solution for integrating official holiday data into their applications and services.
Powered by the ultra-fast Bun runtime, Liburin was designed with performance and simplicity as its primary focus. Instead of relying on traditional external databases, the system operates using automated weekly data updates through web scraping from official reference sources, allowing the API to remain lightweight while continuously maintaining fresh and reliable data.
One of the key technical highlights of Liburin is its high-performance server architecture using Bun.serve(), enabling millisecond-level response times with minimal overhead. The system is optimized for speed, making it suitable for modern applications that require fast and reliable holiday-related data access.
To ensure data consistency and reduce manual maintenance, Liburin integrates automated workflows through GitHub Actions. Every week, the system automatically fetches and updates the latest holiday calendar information from trusted Indonesian calendar sources, storing the refreshed data directly within the repository.
The API also prioritizes timezone accuracy by implementing Indonesia local time calculations (GMT+8) for dynamic endpoints such as /api/today and /api/tomorrow. This guarantees precise date transitions regardless of the hosting server’s timezone configuration, ensuring reliable real-time holiday detection for Indonesian users.
In addition to the backend API infrastructure, Liburin includes an interactive documentation and sandbox interface featuring a sleek dark-mode glassmorphism design built with Tailwind CSS. Developers can instantly test API requests directly from the documentation page, improving usability and developer experience.
The API provides several endpoints, including:
Holiday status for today and tomorrow
Monthly holiday listings
Custom holiday filtering by month and year
Metadata endpoints for update timestamps and total dataset information
All responses are served in JSON format with open CORS headers, making the API easily accessible from frontend applications, mobile apps, and third-party services without additional configuration.
From a development perspective, Liburin was created with a clean and modern developer workflow in mind, utilizing Bun for runtime performance, Tailwind CSS for UI styling, GitHub Actions for automation, and a fully open-source MIT license model.
Overall, Liburin represents a practical and developer-friendly infrastructure project focused on delivering reliable Indonesian holiday data through a modern, scalable, and low-maintenance architecture.