Skip to content

MHMITHUN/Ramadan-Countdown-Api-Create

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

Ramadan Countdown 🌙

A beautiful, modern, and dynamic web application that provides a live countdown to the next Ramadan, complete with a public API.
View Live Preview »

Vercel Status License: MIT


🌟 Live Preview

Experience the live countdown in action! This project features an elegant, responsive interface with an Islamic-inspired aesthetic.

https://ramadan-countdown-create.vercel.app/

Ramadan Countdown Live Preview

✨ Key Features

This project is more than just a countdown. It's packed with modern features to create a rich user experience.

  • Live Countdown Timer: Real-time countdown to the next Ramadan, updating every second.
  • Dynamic Upcoming Date: Automatically displays the specific date for the next Ramadan.
  • Live Hijri Date: Shows the current Islamic (Hijri) date fetched from a live API.
  • Elegant & Responsive Design: A beautiful, modern UI with a "frosted glass" effect and an Islamic vibe that looks great on all devices.
  • Preloader with a Personal Message: A unique loading screen that displays a personal message for a minimum duration, ensuring it's readable.
  • Public API Endpoint: A free-to-use public API that provides the countdown data in JSON format.
  • Built with Modern Tech: Uses serverless functions for the backend API and clean HTML/CSS/JS for the frontend.

🚀 Public API Usage

You can use the public API for your own projects. It's simple, fast, and requires no authentication.

Endpoint URL:

[https://ramadan-countdown-create.vercel.app/api/countdown](https://ramadan-countdown-create.vercel.app/api/countdown)

Example JSON Response:

{
  "ramadanStartDate": "2026-02-18T00:00:00.000Z",
  "currentDate": "2025-08-30T14:30:00.000Z",
  "countdown": {
    "days": 171,
    "hours": 9,
    "minutes": 30,
    "seconds": 0
  },
  "repository": "[https://github.com/MHMITHUN/Ramadan-Countdown-Create](https://github.com/MHMITHUN/Ramadan-Countdown-Create)"
}

💻 Technology Stack

This project is built using a modern, lightweight, and efficient technology stack.

  • Backend: Vercel Serverless Functions (Node.js)
  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • Deployment: Vercel
  • External APIs: Aladhan API for Hijri date.
  • Fonts: Google Fonts (Cinzel Decorative & Poppins)

🛠️ Setup and Deployment

Want to run this project yourself? Follow these simple steps.

  1. Clone the repository:
    git clone [https://github.com/MHMITHUN/Ramadan-Countdown-Create.git](https://github.com/MHMITHUN/Ramadan-Countdown-Create.git)
  2. Navigate to the project directory:
    cd Ramadan-Countdown-Create
  3. Deploy with Vercel:
    • Push the repository to your own GitHub account.
    • Import the repository into your Vercel dashboard.
    • Vercel will automatically detect the settings and deploy the project.

🙏 Acknowledgements

  • All praise is due to Allah (SWT).
  • Thank you to all visitors who take a moment to make a dua.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Count Ramadan Time Simultaneously

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors