Skip to content
Abbasa5251Public

About

Hourline: world clock & time zone converter that gets daylight saving right (Expo / React Native)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Hourline: every time zone, any moment

Hourline

A world clock and time zone converter for Android that gets daylight saving right, every time.

👉 Join the closed beta on Google Play  ·  Website  ·  Privacy policy  ·  Contributing

License: MIT Platform: Android Expo SDK 57


Join the beta

Hourline is in closed testing on Google Play. Joining takes about two minutes:

  1. Go to hourline.adevtutorials.in/#beta.
  2. Join the tester group with the Google account you use in Google Play.
  3. Tap Become a tester, then install Hourline from Google Play.

Please keep it installed for at least 14 days. Google requires that before the app can go public. Send feedback to hello@adevtutorials.in.

Screenshots

Home: every city at a glance Time travel with the dial and week strip Compare: find the hour that works Convert any time, including UTC
Clock-change alerts Dark mode Quick setup

These are real screenshots from the app. See marketing/README.md for how they're made.

Features

  • Every city at a glance: the time, how far ahead or behind, and who is on daylight saving, with real zone names (BST, AEDT…).
  • Time travel: drag the dial in 15-minute steps, or swipe the week strip to any date in the past or future. When clocks change in between, Hourline says so ("GMT · DST ended").
  • Compare: an hour grid of work, free and sleep hours for every city, with the best meeting overlap picked for you.
  • Convert: pick a date and time in one city and see it everywhere, including UTC. You're warned about times skipped when clocks spring forward.
  • Clock-change alerts: shown when a change is coming within 30 days, with the new gap between your cities.
  • Accurate everywhere: the app ships its own time zone rules, so every phone gives the same answer.
  • Private: no account, no ads, no tracking. Everything stays on your phone.
  • Light and dark themes, a 12/24-hour clock, haptic feedback, 2,200+ cities searchable offline.

How accuracy is checked

  • Bundled rules: time zone rules come from IANA tzdb 2026e, via the FormatJS Intl.DateTimeFormat polyfill (src/lib/intl.ts). The phone's own, possibly outdated, rules are never used.
  • timeanddate.com cross-check: src/lib/tz-timeanddate.test.ts compares the engine with 240 conversions and 19 clock changes captured from timeanddate.com. Known differences are documented in the test.
  • On-device self-check: dev builds have one under Settings → Run time-zone self-check.

Tech stack

  • Expo SDK 57 (React Native, Hermes, New Architecture), with Expo Router
  • Luxon for time zone maths, in src/lib/tz.ts
  • react-native-gesture-handler, react-native-svg, expo-haptics, expo-localization, AsyncStorage
  • Jest (jest-expo) for tests
  • EAS Build for signed release builds
  • The website is static HTML on Vercel

Project structure

src/app/            screens (Expo Router): onboarding, (tabs)/ home·compare·convert·settings, add-city modal
src/components/     dial, week strip, city row, pill tab bar, haptic Pressable, …
src/lib/            time zone engine, abbreviations, cities, compare logic, haptics, tests
src/state/          app state (AsyncStorage)
src/data/           cities.json (generated from GeoNames by scripts/build-cities.mjs)
plugins/            config plugin for release signing
site/               hourline.adevtutorials.in (landing page, beta signup, privacy policy)
marketing/          raw screenshots and Google Play graphics
docs/               publishing guide, release notes, privacy policy

Development

npm install
npm run android          # build and install the development build on an emulator/device
npx expo start --dev-client

Before committing, run:

npx expo lint
npx tsc --noEmit
npm test                 # includes the timeanddate.com cross-check

android/ and ios/ are generated by expo prebuild and are not committed. Configure native behaviour in app.json and plugins/.

Releasing

Production builds are signed AABs built with EAS:

npx eas-cli@latest build --platform android --profile production

Contributing

Hourline is open source and contributions are welcome. Bug reports with the exact city, date and time are especially useful. Read CONTRIBUTING.md before opening a pull request. master is protected, so every change goes through a reviewed PR.

Privacy

Hourline collects no data. See the privacy policy.

Credits

License

MIT © 2026 Abbas Anandwala

About

Hourline: world clock & time zone converter that gets daylight saving right (Expo / React Native)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages