Skip to content

tanvir-cpp/ramadan-2026

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

17 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Ramadan 2026 πŸŒ™

Live Sehar & Iftar countdown with a full 30-day calendar β€” built for Bangladesh.

Tailwind is compiled at build time, so the deployed site is pure static HTML/CSS/JS.

HTML CSS JS PWA

Features

  • Live countdown to the next Sehar or Iftar with a progress bar
  • 30-day calendar β€” full Ramadan timetable at a glance, today auto-highlighted
  • 10 cities β€” Dhaka, Chittagong, Sylhet, Rajshahi, Khulna, Barishal, Rangpur, Comilla, Mymensingh, Gazipur
  • Bengali / English toggle β€” UI, dates, and numbers switch instantly
  • Prayer times tray β€” Fajr through Isha in an expandable panel
  • Hijri date and live clock in the header
  • Fullscreen mode for a clean, immersive view
  • Installable PWA β€” works offline after first load via service worker
  • Ramadan day counter β€” "Day X of 30" when it's Ramadan

How it works

Prayer times come from the Aladhan API (Method 1 β€” University of Islamic Sciences, Karachi). The app fetches the full month's calendar once per city, caches it in localStorage, and handles everything else client-side β€” countdown, progress bar, language switching, time formatting.

The 30-day calendar fetches both February and March data, filters for Hijri month 9 (Ramadan), and renders the full timetable.

Running locally

git clone https://github.com/tanvir-cpp/ramadan-2026.git
cd ramadan-2026
npm install
npm run build

Open index.html directly, or serve it:

npx serve .

During development, run npm run watch to auto-rebuild CSS on any change.

Project structure

β”œβ”€β”€ index.html             # Main page β€” countdown, cards, prayer tray
β”œβ”€β”€ calendar.html          # 30-day Ramadan calendar
β”œβ”€β”€ manifest.json          # PWA manifest
β”œβ”€β”€ sw.js                  # Service worker (offline caching)
β”œβ”€β”€ tailwind.config.js     # Tailwind theme (colors, fonts)
β”œβ”€β”€ package.json           # Build scripts
β”œβ”€β”€ css/
β”‚   β”œβ”€β”€ input.css          # Source CSS (Tailwind directives + custom)
β”‚   └── style.css          # Built output (minified)
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ shared.js          # Shared data β€” cities, utilities, helpers
β”‚   β”œβ”€β”€ app.js             # Main page logic β€” countdown, API, rendering
β”‚   └── calendar.js        # Calendar page logic β€” fetch, render, scroll
└── assets/
    β”œβ”€β”€ hero-bg.jpg         # Compressed background (243 KB)
    └── icon.svg            # PWA icon (crescent moon)

Built with

  • Tailwind CSS (CDN) β€” styling and layout
  • Lucide Icons β€” map-pin, calendar, moon-star, utensils, chevrons
  • Google Fonts β€” Inter, Outfit, Noto Sans Bengali
  • Aladhan API β€” prayer time data

License

MIT

About

πŸŒ™ Ramadan 2026 Sehar & Iftar countdown timer for Dhaka, Bangladesh - bilingual (Bengali/English) with Tailwind CSS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors