Skip to content

πŸ•°οΈ A lightweight and responsive world clock built in vanilla HTML/CSS/JS with timezone support and theme switching.

License

Notifications You must be signed in to change notification settings

notelyoo/WorldTimeZone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 WorldTimeZone – Simple & Stylish Timezone Clock πŸ•°οΈ

Welcome to WorldTimeZone, a minimal and responsive world clock app built in vanilla HTML/CSS/JS.
It allows users to browse timezones, view live clocks, and switch between themes β€” all with smooth UI interactions.


🌟 Features

  • πŸ•’ Real-Time Clock – Displays the current time and date for a selected city
  • 🌐 18+ Timezones – Easily switch between major global timezones
  • 🎌 Emoji Flags – Country flags with city names for better clarity
  • πŸŒ“ Theme Switcher – Toggle between light and dark themes (with emoji buttons)
  • πŸ“± Responsive Design – Mobile-friendly and sleek layout
  • ⚑ Pure Frontend – No frameworks, no libraries β€” 100% vanilla JS

πŸ› οΈ Technologies Used

  • HTML5 – Semantic layout structure
  • CSS3 – Flexbox, transitions, dark/light mode
  • JavaScript (ES6) – Timezone switching, DOM interaction, real-time updates
  • Google Fonts – IBM Plex Mono

πŸ“‚ Project Structure

WorldTimeZone/
β”‚
β”œβ”€β”€ index.html        β†’ Main HTML structure
β”œβ”€β”€ style.css         β†’ All styling and themes
β”œβ”€β”€ script.js         β†’ Clock logic, city menu, theme switching
β”œβ”€β”€ favicon.ico       β†’ Page favicon

πŸš€ Getting Started

1️⃣ Clone the Repository

git clone https://github.com/NotElyoo/WorldTimeZone.git
cd WorldTimeZone

2️⃣ Open in Browser

Just open index.html with your favorite browser:

open index.html

βœ… No build step or dependencies required.


πŸ’‘ How It Works

  • When the page loads, it defaults to Paris (GMT+1).
  • You can open the dropdown to select a city β€” the time updates instantly.
  • Theme icons (🌞/πŸŒ™) let you toggle between light/dark modes.
  • The clock updates every second using setInterval() and adjusts according to the selected timezone via Intl.DateTimeFormat.

✨ Demo

A live version will be available soon (or feel free to host it yourself via GitHub Pages!)


πŸ“’ Contributing

Feel free to fork the project, suggest improvements or create pull requests!

git checkout -b feature/your-feature
git commit -m "Add your feature"
git push origin feature/your-feature

πŸ“œ License

This project is licensed under custom terms written by the author:

  • βœ… You are free to view, use, and modify the code for non-commercial purposes.
  • βœ… Attribution is required β€” please credit the author by name or link.
  • ❌ Commercial use of this code is not permitted without explicit permission.

Please refer to the LICENSE file for full details.


πŸ“¬ Contact

πŸ“§ Email: contact@miyeon.fr
🐦 Twitter: @NotElyoo


πŸ“Œ Future Improvements (Ideas πŸ’‘)

βœ… Add analog clock mode
βœ… Add option to save preferred city in localStorage
βœ… Support more cities / timezones
βœ… Localized language support (FR/EN)
βœ… Animations on theme change

About

πŸ•°οΈ A lightweight and responsive world clock built in vanilla HTML/CSS/JS with timezone support and theme switching.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published