🕌 Namaz Vakti

Native macOS (menu bar) and iOS apps for Muslim prayer times — powered by the Turkish Directorate of Religious Affairs (Diyanet).

---

On macOS, Namaz Vakti lives in your menu bar with a live countdown to the next prayer and opens into a full window for more detail. On iOS, it's a tabbed app (Today / Monthly / Settings). Both are built from the same Core logic and the same SwiftUI views.

📸 Screenshots

macOS

Menu bar	Main window

iOS

Today	Today (dark)	Monthly	Qibla	Settings

Lock Screen, Live Activity & Dynamic Island

The next-prayer Live Activity and a prayer-time notification, live on the Lock Screen:

Dynamic Island — the same Live Activity, compact / minimal / expanded (preview)

Lock Screen widgets — rectangular, circular, and inline accessory families (preview)

The Dynamic Island and Lock Screen-widget images are previews — those surfaces don't render into headless Simulator captures (the Lock Screen shot above is a real-device capture).

✨ Features

• Menu bar countdown — the next prayer with a live, jitter-free countdown (e.g. Afternoon 1:23:45).
• Dropdown panel — today's six times with the next one highlighted, location, and the Gregorian + Hijri date.
• Main window (macOS) — sidebar with Today (rich view), Monthly, and Settings. A Dock icon appears only while the window is open.
• iOS app — the same Today / Monthly / Settings as a tab bar, with a responsive Today hero.
• Monthly — a spacious Focus Card for one day over a compact month chart (each day a thin row, the six prayers as colored dots in equal columns); tap any day to promote it.
• Home Screen widget — small / medium WidgetKit widget with the next prayer and a live countdown.
• Lock Screen widgets (iOS) — rectangular, circular, and inline accessory families.
• Dynamic Island & Live Activity (iOS) — a user-toggled next-prayer countdown in the Dynamic Island (compact / minimal / expanded) and on the Lock Screen.
• Qibla finder (iOS) — a live compass that points to the Kaaba, using your location for a true-north bearing, with figure-8 calibration and a "facing the Qibla" cue (and haptic).
• App icon — a flat crescent & star, shipped for both apps.
• Notifications — optional local notifications at each prayer time.
• Location — Automatic mode tracks your current city (reverse-geocoded to the nearest Diyanet district) or Pinned mode keeps a city you choose (country → city → district). Each location's month is cached, so revisiting one makes no extra request.
• Localized — English, Turkish, and Arabic (right-to-left), including the app name and locale-aware Gregorian + Hijri dates. Adding a language →
• Themes — a Default theme (the system look, auto light/dark) and a dark/gold Arc theme (with bundled Fraunces / Hanken Grotesk / Spline Sans Mono fonts), chosen in Settings → Appearance and applied app-wide on both platforms.
• Accessibility — full Dynamic Type scaling (including the hero countdown) and automatic dark mode.

📋 Requirements

• macOS 14 (Sonoma) or later, and/or iOS 17 or later
• Xcode 26+ to build
• XcodeGen — brew install xcodegen

🚀 Build & run

brew install xcodegen
xcodegen generate                       # regenerate NamazVakti.xcodeproj from project.yml
xcodebuild -scheme NamazVakti -destination 'platform=macOS' \
  -derivedDataPath build/DerivedData build
open build/DerivedData/Build/Products/Debug/NamazVakti.app

For iOS, build for the Simulator and launch it on a booted device:

xcodebuild -scheme NamazVaktiiOS -destination 'generic/platform=iOS Simulator' \
  -derivedDataPath build/DerivedData build
xcrun simctl install booted build/DerivedData/Build/Products/Debug-iphonesimulator/NamazVaktiiOS.app
xcrun simctl launch booted com.olcayertas.NamazVakti.iOS

Run the tests (pure schedule + decoding logic, no network):

xcodebuild test -scheme NamazVakti -destination 'platform=macOS' -derivedDataPath build/DerivedData

Uses local ad-hoc signing — no Apple Developer account required. Re-run xcodegen generate whenever you add or remove source files.

🧭 Data source

Prayer times come from the no-auth EzanVakti wrapper of Diyanet's published tables:

GET https://ezanvakti.emushaf.net/vakitler/{districtId}   # one call = a full month

The hierarchy endpoints (/ulkeler, /sehirler/{id}, /ilceler/{id}) drive the location picker. Everything goes through a PrayerTimesProvider protocol, so the official Diyanet AwqatSalah API can be dropped in later without touching the UI.

🏗️ Architecture

• Sources/Core — UI-free, shared by every target: PrayerDay, PrayerSchedule (next-prayer math in Europe/Istanbul), PrayerCache, PrayerTimesProvider / PlacesProvider (EzanVakti), PrayerStore, NotificationScheduler, Qibla (great-circle bearing to the Kaaba — pure, so it's unit-tested without a device), LocationTracker (CoreLocation) + LocationResolver (reverse-geocode → Diyanet district, with a pure, unit-tested Turkish-aware name matcher), and the shared Localizable.xcstrings.
• Sources/Shared — cross-platform SwiftUI used by both apps: the Today / Settings views and the location picker; the Theme system (Theme/ThemeID/ThemeManager + \.theme environment + Default/Arc tokens) in Theme/; the redesigned Monthly (Monthly/ — MonthlyDay, DayRowLayout, MonthChart, the Focus Card) in MonthView; DateLocalizer; the Color.cardBackground shim; and the bundled Arc fonts in Fonts/.
• Sources/App (macOS) — MenuBarExtra menu bar item + the MainWindowView sidebar shell.
• Sources/iOS (iOS) — PrayerTimesApp entry point + RootTabView tab bar, and the Qibla compass (QiblaController wrapping CoreLocation heading/location + QiblaView). The compass is iOS-only — Macs have no magnetometer, so it's filtered out of the macOS sidebar.
• Sources/Widget — WidgetKit timeline provider and views (Home Screen + iOS Lock Screen accessory families), built into both the macOS and iOS widget extensions.
• Sources/LiveActivity (iOS) — the ActivityKit attributes and the Live Activity / Dynamic Island UI, shared by the iOS app and its widget.

Notable decisions

• App Group (group.com.olcayertas.NamazVakti) — the app and widget share the selected district + cached month, so the widget follows your Automatic/Pinned location (not a fixed default). It degrades gracefully to per-process storage when the entitlement is absent, and a one-time migration carries over a district saved before the App Group existed.
• Themes are a value-type token set in \.theme (Default = system semantics so it's pixel-identical to the un-themed look; Arc = fixed dark palette + bundled fonts, and forces .dark). The widget / Live Activity / Dynamic Island / menu-bar title can't read the runtime theme (separate processes / plain String), so they keep the system look.
• Automatic location is Turkey-focused — it reverse-geocodes to a Diyanet (EzanVakti) district; outside Türkiye, or when permission is denied, it falls back to the pinned/default city.
• Swift 6 language mode with complete strict concurrency. Networking is async/await (URLSession.data(from:)) behind a Sendable PrayerTimesProvider; the @MainActor PrayerStore awaits it from a cancellable Task, and a structured Task (not a GCD timer) drives the once-a-second countdown.
• The menu bar uses a plain String title with monospaced digits: a rendered MenuBarExtra label hangs AppKit's status-item sizing on macOS 26. (This — not async/await — was the real cause of an earlier hang, so the data layer is free to use modern concurrency.)
• Localized via String Catalogs (English source · Turkish · Arabic with RTL) — including the app/widget names and locale-aware Gregorian + Hijri dates. See docs/LOCALIZATION.md.

🗺️ Roadmap

• Official Diyanet AwqatSalah provider
• Location-aware widget (per-widget configuration)
• More languages — prioritized by Muslim population
• Launch at login (macOS); localized Live Activity / Settings strings

📄 License

Released under the MIT License © 2026 Olcay Ertaş.

Prayer-time data © T.C. Diyanet İşleri Başkanlığı, accessed via the community EzanVakti service. This project is not affiliated with or endorsed by Diyanet.