Cross-TimeZone Email Planner 🌍📧

A modern web application built with Next.js that helps users schedule emails across different time zones with precision and ease.

Features ✨

• Intuitive City Selection: Search and select cities with a user-friendly interface
• Real-time Time Zone Conversion: Instantly convert times between different cities
• Time Difference Display: Shows the exact time difference between selected cities
• Current Time Display: Shows the current time in the target city
• Precise Time Format: Displays both user-friendly and precise time formats
• Error Handling: Clear error messages for invalid inputs
• Responsive Design: Works seamlessly across all device sizes
• Accessibility: Built with ARIA labels and keyboard navigation support
• Dark Mode Support: Automatic theme switching based on system preferences

Tech Stack 🛠️

• Framework: Next.js 13
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Icons: Lucide React
• Date/Time Handling: Moment.js with Timezone Support
• State Management: React Hooks

Getting Started 🚀

Prerequisites

• Node.js 16.8 or later
• npm or yarn package manager

Installation

1. Clone the repository:

   git clone https://github.com/anishjoshi1999/Cross-TimeZone-Email-Planner.git
   cd cross-timezone-email-planner

2. Install dependencies:

   npm install
   # or
   yarn install

3. Start the development server:

   npm run dev
   # or
   yarn dev

4. Open http://localhost:3000 in your browser

Usage 📝

1. Select Your City

   • Click on the "Your City (A)" dropdown
   • Search or scroll to find your city
   • Select your city from the list

2. Select Target City

   • Click on the "Target City (B)" dropdown
   • Search or scroll to find the target city
   • Select the target city from the list

3. Set Target Time

   • Use the datetime picker to select when you want the email to be sent in the target city

4. Convert Time

   • Click the "Convert Time" button
   • View the converted time, time difference, and current time in the target city

5. Schedule Your Email

   • Use the converted time to schedule your email in your preferred email client

Features in Detail 🔍

Time Conversion

• Converts times between cities while accounting for daylight saving time
• Shows time difference between cities
• Displays current time in target city

City Selection

• Searchable dropdown for city selection
• Organized list of major cities worldwide
• Easy-to-use interface

Error Handling

• Validates date and time inputs
• Provides clear error messages
• Prevents invalid conversions

Responsive Design

• Mobile-first approach
• Adapts to different screen sizes
• Optimized for both desktop and mobile use

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments 🙏

• Next.js
• Tailwind CSS
• shadcn/ui
• Moment.js
• Lucide Icons

Support 💬

If you have any questions or need help, please open an issue in the repository.