Skip to content

aashishbharti04/worldclock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

🌍 WorldClock

Time zones & meeting planner for a global world

See the current time across cities worldwide, then instantly find the best overlapping hours to meet across time zones. Accurate (DST-aware via the browser's built-in timezone data), private, and 100% in your browser.

Stack Offline No deps License

πŸš€ Live demo Β· πŸ›οΈ Architecture Β· 🀝 Contributing


πŸ“– Project overview

Coordinating across time zones is one of the quiet daily frictions of remote and global work: "Is 3pm my time a reasonable hour for my teammate in Tokyo?" WorldClock answers that at a glance. Add the cities you care about to see live clocks, set everyone's working hours, and the meeting planner highlights the windows when everyone is awake and working β€” no math, no spreadsheets. It uses the browser's built-in IANA timezone database (via the Intl API), so results are accurate and DST-aware with zero external data and zero network calls.

πŸ“Έ Screenshot

WorldClock: live city clocks and a meeting-planner grid highlighting overlapping working hours

Live clocks + the meeting planner finding the overlapping working window across cities (dark mode).

✨ Features

  • πŸ•’ Live world clocks β€” add cities and watch their current time, date, day/night, and UTC offset update in real time
  • πŸ—“οΈ Meeting planner β€” a 24-hour grid that highlights the hours when all your cities are within working hours
  • 🟒 Best meeting windows β€” automatically lists the overlapping time ranges in your reference city
  • πŸ“Œ Pin any hour to see the exact local time & date in every city at that instant
  • ⭐ Reference city β€” set any city as the planner's anchor
  • βš™οΈ Adjustable working hours, 12/24-hour format
  • 🌍 ~65 major cities across every region, searchable by city or country (with flag emoji)
  • πŸŒ— Dark/light mode; your cities & settings persist locally
  • πŸ”’ 100% client-side β€” accurate IANA/DST time math via Intl, no servers, no tracking, works offline
  • 🧩 Zero dependencies, zero build step

πŸš€ Installation

Static site β€” no build, no install.

git clone https://github.com/aashishbharti04/worldclock
cd worldclock
python -m http.server 8000        # or: npx serve .
# open http://localhost:8000

Or just open the live demo.

πŸ•ΉοΈ Usage

  1. Search for a city and click to add it (it seeds with your local zone + a few hubs).
  2. Click β˜… on a card to make it the planner's reference city.
  3. Set everyone's working hours; the planner highlights columns where all cities overlap.
  4. Read the Best meeting windows card, or click a column to pin a time and see it in every city.
  5. Toggle 12-hour format or Reset to now anytime.

βš™οΈ Configuration

No configuration or secrets. Your selected cities, reference, working hours, and format are saved to localStorage.

☁️ Deployment

Auto-deploys to GitHub Pages via .github/workflows/pages.yml (Settings β†’ Pages β†’ Source: GitHub Actions). Fully static, so it also runs on Netlify, Vercel, Cloudflare Pages, or any web server. See docs/DEPLOYMENT.md.

πŸ—‚οΈ Folder structure

worldclock/
β”œβ”€β”€ index.html              # app shell (hero, search, clocks, planner)
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ css/style.css       # design system, clocks grid, planner grid, responsive
β”‚   └── js/
β”‚       β”œβ”€β”€ cities.js       # curated city β†’ IANA timezone dataset (+ flag emoji)
β”‚       β”œβ”€β”€ tz.js           # timezone math via Intl (offsets, zoned parts, formatting)
β”‚       └── app.js          # state, live clocks, planner overlap logic, search, theme
β”œβ”€β”€ docs/                   # architecture, deployment, screenshot
└── .github/                # workflows + issue/PR templates

❓ FAQ

How is the time accurate without a backend? It uses Intl.DateTimeFormat with IANA time zones β€” the same timezone database your OS/browser ships β€” so offsets and DST are correct.

Does it track me or upload anything? No. Everything runs locally; there are no network calls except loading the UI web font.

Why isn't my exact city listed? The list covers major cities per zone. Any city in the same IANA zone shows the same time β€” pick the nearest hub. PRs to add cities are welcome!

Does it handle Daylight Saving Time? Yes β€” DST transitions come from the browser's timezone database automatically.

🀝 Contributing

PRs welcome β€” adding cities is a one-line change! See CONTRIBUTING.md and the Code of Conduct. Security reports: SECURITY.md.

πŸ“„ License

MIT Β© Aashish Bharti β€” free for educational, learning, and community use.


πŸ“¬ Contact & Connect

Email: aashish@marketdoctorsonline.com

LinkedIn Β· GitHub Β· YouTube Β· Instagram

Β© WorldClock. All rights reserved. Β· This project is open source and available for educational, learning, and community contributions.

About

🌍 World clock & meeting planner β€” compare time zones and find the best overlapping hours to meet. DST-accurate, 100% client-side, zero dependencies. Live on GitHub Pages.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors