omniversify/amazigh-date-api

A beautiful, lightweight API that provides dates across three major calendars used in Morocco: ⴰⵎⴰⵣⵉⵖ Amazigh (Berber) 🏔️, Gregorian 📅, and Islamic (Hijri) 🌙. Built with Hono ⚡ and Bun 🥟 for blazing-fast performance 🚀. # ⴰⵎⴰⵣⵉⵖ Amazigh Date API A beautiful, lightweight API that provides dates across three major calendars used in Morocco: **ⴰⵎⴰⵣⵉⵖ Amazigh (Berber)** 🏔️, **Gregorian** 📅, and **Islamic (Hijri)** 🌙. Built with Hono ⚡ and Bun 🥟 for blazing-fast performance 🚀. **✨ Features:** - 🌐 **Smart Content Negotiation**: Automatically serves beautiful UI to browsers, JSON to API clients - 📅 **Three Calendar Systems**: Amazigh, Gregorian, and Islamic calendars - ⵜ **Tifinagh Support**: Native Berber script for numbers and month names - 🇲🇦 **Morocco Time**: All times in Africa/Casablanca timezone - ⚡ **Lightning Fast**: Built on Bun runtime with Hono framework - 🎨 **Moroccan Luxury UI**: Premium gold-themed interface inspired by Moroccan aesthetics --- ## 🚀 Quick Start ### Prerequisites - Bun installed on your system ### Installation ```bash # Clone the repository git clone github.com cd amazigh-date-api # Install dependencies bun install # Start the development server bun run dev ``` The API will be available at `localhost` --- ## 📖 API Documentation ### Base URL ``` localhost ``` ### Endpoints Overview | Endpoint | Description | Returns | |----------|-------------|---------| | `GET /` | Interactive API documentation | HTML UI | | `GET /api/time` | Current date in all calendars | JSON/HTML | | `GET /api/times` | Multiple future dates | JSON/HTML | --- ## 🔗 Detailed Endpoint Reference ### 1. Documentation Page ``` GET / ``` **Description**: Interactive documentation page listing all available endpoints with examples. **Example**: ```bash curl localhost ``` --- ### 2. Current Date (All Calendars) ``` GET /api/time ``` **Description**: Returns the current date in Amazigh, Gregorian, and Islamic calendars. **Query Parameters**: | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `calendar` | string | all | Specific calendar: `amazigh`, `grego …