Vacation Time Optimizer 🏖️

A smart vacation planning app that helps you maximize your time off by finding optimal vacation periods around holidays.

✨ Features

🎯 Smart Vacation Planning

• Efficiency Scoring: Shows how many total days off you get per vacation day used
• Holiday Integration: Automatically includes government and company holidays
• Optimal Recommendations: AI-powered suggestions for the best vacation periods

📅 Multiple Calendar Views

• Month View: Traditional single-month calendar
• Quarter View: See 3 months at once for better planning
• Year View: Full year overview with all holidays visible
• Touch Navigation: Swipe between months on mobile devices

🌍 International Support

• Multi-Country Holidays: Support for US, Canada, UK, Australia, Germany, France, Japan
• Country Selector: Easy dropdown to switch between countries
• Localized Holiday Names: Holidays shown in local language

📱 Mobile-First Design

• Responsive Layout: Optimized for all screen sizes
• Collapsible Sections: Mobile drawers for better space usage
• Touch-Friendly: Large touch targets and swipe gestures

📤 Calendar Export

• iCal File Download: Download .ics files compatible with most calendar apps
• Google Calendar Integration: Direct link to add events to Google Calendar
• Outlook Integration: Direct link to add events to Outlook.com
• Universal Compatibility: Works with Apple Calendar, Outlook desktop, Thunderbird, and more

🚀 Getting Started

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

🛠️ Tech Stack

• React 18 with TypeScript
• Tailwind CSS for styling
• Vite for development and building
• Lucide React for icons

📋 Upcoming Features

Premium Features (Coming Soon)

• Save and name vacation plans
• Export to calendar apps
• Team coordination features
• Historical analytics

Mobile Enhancements

• PWA support
• Offline functionality
• Push notifications for vacation reminders

🎨 Design Philosophy

The app follows a mobile-first, progressive enhancement approach:

• Core functionality works on all devices
• Enhanced features available on larger screens
• Beautiful, modern UI that doesn't sacrifice usability

📱 Mobile Protection Strategy

The app protects your existing web experience while enhancing mobile:

• Desktop First: Full-featured desktop experience preserved
• Mobile Enhanced: Additional mobile-specific features
• Progressive: Features gracefully degrade on smaller screens

📄 License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

👨‍💻 Author

John Turner

🤝 Contributing

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

📞 Support

If you have any questions or need help, please open an issue on GitHub.