# TimeSync by SwirlyPeak

> A minimal, beautifully designed time zone comparison web app for professionals coordinating international meetings.

## Overview

TimeSync is a React-based web application that helps users compare times across different time zones. It features an intuitive carousel interface for time selection, automatic timezone detection, and a clean, modern design with both light and dark themes.

## Key Features

- **Interactive Time Cards**: Tap-to-edit interface with carousel controls for hours and minutes
- **Multiple Time Zones**: Add and compare unlimited time zones simultaneously
- **12/24 Hour Format**: Toggle between 12-hour (AM/PM) and 24-hour time formats
- **City Search**: Search and add cities from a comprehensive database using city-timezones and Luxon
- **Theme Support**: Light and dark mode with smooth transitions
- **Responsive Design**: Works seamlessly on desktop and mobile devices
- **Privacy Focused**: GDPR-compliant with optional Google Analytics (opt-in only)
- **Local Storage**: All preferences stored locally in browser

## Technical Stack

- **Frontend**: React 18, TypeScript, Vite
- **Styling**: Tailwind CSS with custom design system
- **Time/Timezone**: Luxon, city-timezones
- **UI Components**: shadcn/ui (Radix UI primitives)
- **State Management**: React Context API
- **Routing**: React Router v6
- **Typography**: Departure Mono (display), Inter (UI)
- **Analytics**: Google Analytics 4 (opt-in)

## Design Philosophy

TimeSync prioritizes simplicity and usability. The interface uses a card-based design with slate backgrounds, a distinctive red accent color (#DC2626), and the Departure Mono monospace font for time display. The tap-to-edit pattern reduces visual clutter while maintaining full functionality.

## Privacy & Compliance

- GDPR-compliant cookie consent banner
- No personal data collection
- Optional analytics with explicit user consent
- All timezone preferences stored locally
- Transparent privacy policy at /privacy

## Use Cases

- Scheduling international meetings
- Coordinating with remote teams across time zones
- Planning travel and calls
- Quick time zone conversion
- Understanding time differences at a glance

## Creator

Built by SwirlyPeak
Contact: hello@swirlypeak.com
Website: https://time-sync-five.vercel.app/

## Open Source

This project is open source and available on GitHub.
Contributions and feedback welcome!