https://github.com/skp3214/holidayscheduler
https://github.com/skp3214/holidayscheduler
calendarific-api country-code-api gson-library holiday-scheduler holiday-tracker holidays-api java javaswing maven mysql-database
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/skp3214/holidayscheduler
- Owner: skp3214
- Created: 2024-04-17T10:53:34.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T21:25:51.000Z (almost 2 years ago)
- Last Synced: 2025-01-06T19:39:01.502Z (over 1 year ago)
- Topics: calendarific-api, country-code-api, gson-library, holiday-scheduler, holiday-tracker, holidays-api, java, javaswing, maven, mysql-database
- Language: Java
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎉 Holiday Scheduler 🗓️
Welcome to **Holiday Scheduler**, a vibrant Java-based application designed to make holiday planning a breeze! 🌍 Whether you're exploring holidays across different countries or curating your dream vacation list, this app has you covered with a sleek and intuitive interface. Built with **Java Swing**, it’s your perfect companion for holiday management! 🚀
## ✨ Features
- 🌎 **View Holidays**: Discover holidays for various countries and years.
- 📅 **Filter Holidays**: Narrow down holidays by **month** or **day of the week**.
- ❤️ **Wishlist Feature**: Save your favorite holidays to a wishlist and manage them effortlessly.
- 🗑️ **Remove Holidays**: Easily remove holidays from your wishlist.
- 🖥️ **User-Friendly GUI**: A smooth and interactive interface powered by Java Swing.
## 🚀 Getting Started
To embark on your holiday planning adventure, ensure you have the **Java Development Kit (JDK)** installed on your machine.
1. 📥 **Clone or Download**: Grab the repository or source code.
2. 🖌️ **Open in IDE**: Load the project in your favorite Integrated Development Environment.
3. 📂 **Locate Main.java**: Find the `Main.java` file in the `org.example` package.
4. ▶️ **Run the App**: Compile and execute `Main.java` to launch the Holiday Scheduler.
## 🛠️ Usage
1. Launch the app to access the **Holiday Scheduler GUI**. 🎨
2. Select a **country** from the dropdown menu. 🌐
3. Enter the desired **year** in the "Year" text field. 📆
4. (Optional) Filter holidays by selecting a **month** or **day of the week** from the dropdowns. 🔍
5. Click **"Show Holidays"** to view holidays based on your selections. 📋
6. Add a holiday to your **wishlist** by clicking a holiday in the **"ALL HOLIDAYS"** list. ❤️
7. Remove a holiday from your **wishlist** by clicking it in the **"WISHED HOLIDAYS"** list. 🗑️
## 📦 Dependencies
The Holiday Scheduler relies on the following external libraries:
- **MySQL Connector/J**: Connects to a MySQL database for storing and retrieving wishlisted holidays. 🗄️
- **Calendarific API**: Fetches holiday data based on user inputs. 🌟
Ensure these dependencies are included in your project’s classpath or managed via tools like **Maven** or **Gradle**.
## 🤝 Contributing
We love contributions! 🙌 If you spot bugs or have ideas to enhance the Holiday Scheduler, feel free to:
- 🐞 Open an **issue** to report problems.
- 💡 Submit a **pull request** with your improvements.
## 🙏 Acknowledgments
A big thank you to:
- **Calendarific API** developers for providing comprehensive holiday data. 🌍
- **MySQL Community** for the reliable MySQL Connector/J library. 🗄️
- **Java Community** for the amazing libraries and resources that power this project. ☕
## 📸 Project Snapshots
Explore the Holiday Scheduler in action! 👇
---
Plan your holidays with ease and style using **Holiday Scheduler**! 🎊 Start exploring today!