Skip to content
/ iftar Public

A beautiful Next.js application that displays a countdown timer to Iftar

License

Notifications You must be signed in to change notification settings

0x0645/iftar

Repository files navigation

Iftar Countdown App

A beautiful Next.js application that displays a countdown timer to Iftar (the time to break fast during Ramadan) based on the user's location.

Features

  • ⏱️ Real-time countdown to Iftar (Maghrib prayer time)
  • 🌃 Beautiful dark mode UI with animated elements
  • 🌐 Works worldwide with accurate prayer times
  • 📱 Fully responsive design for all devices

Technologies Used

  • Next.js 14 with App Router
  • TypeScript
  • Tailwind CSS for styling
  • Luxon for date/time handling
  • Axios for API requests
  • IP Geolocation API (ipinfo.io)
  • Prayer Times API (aladhan.com)

Getting Started

Prerequisites

  • Node.js 18.17 or later
  • npm or yarn

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/iftar-countdown.git
    cd iftar-countdown
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Run the development server:

    npm run dev
    # or
    yarn dev
  4. Open http://localhost:3000 in your browser to see the application.

License

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

Acknowledgements

About

A beautiful Next.js application that displays a countdown timer to Iftar

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published