Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zachd/stretch-my-time-off
Maximise your vacation days 🌴📅
https://github.com/zachd/stretch-my-time-off
Last synced: 3 months ago
JSON representation
Maximise your vacation days 🌴📅
- Host: GitHub
- URL: https://github.com/zachd/stretch-my-time-off
- Owner: zachd
- License: mit
- Created: 2024-11-10T14:58:59.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-22T19:17:53.000Z (3 months ago)
- Last Synced: 2024-11-22T19:20:45.137Z (3 months ago)
- Language: Svelte
- Homepage: https://stretchmytimeoff.com
- Size: 335 KB
- Stars: 133
- Watchers: 1
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Stretch My Time Off
**Stretch My Time Off** is a tool designed to help you optimize your vacation days by aligning public holidays and personal leave. This project was generated entirely with ChatGPT in a code editor designed for AI-assisted development.
Website: https://stretchmytimeoff.com
## Table of Contents
- [About the Project](#about-the-project)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Installation](#installation)
- [Usage](#usage)
- [Algorithm](#algorithm)
- [Contributing](#contributing)
- [License](#license)
- [Acknowledgments](#acknowledgments)
## About the Project
This project was created to efficiently manage vacation days by aligning them with public holidays. It was developed using the Cursor IDE with GPT-4o and is hosted on Vercel with Cloudflare.
## Features
- **Country-Specific Holidays**: Fetches public holidays for your country.
- **Optimized Days Off**: Calculates the best use of personal leave days.
- **Interactive Calendar**: Visualizes holidays and optimized days off.
- **Responsive Design**: Compatible with desktop and mobile devices.
## Tech Stack
- **Framework**: [SvelteKit](https://kit.svelte.dev/)
- **Programming Language**: JavaScript
- **Styling**: CSS
- **Hosting**: [Vercel](https://vercel.com/)
- **CDN and Security**: [Cloudflare](https://www.cloudflare.com/)
- **IDE**: [Cursor IDE](https://cursor.so/)
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/zachd/stretch-my-time-off.git
```
2. **Navigate to the project directory**:
```bash
cd stretch-my-time-off
```
3. **Install dependencies**:
```bash
npm install
```
4. **Start the development server**:
```bash
npm run dev
```
## Usage
Access the application at `http://localhost:3000`. Enter your country to view public holidays and plan your time off using the interactive calendar.
## Algorithm
The algorithm optimizes personal leave days to maximize consecutive days off:
1. **Identify Public Holidays and Weekends**.
2. **Find Gaps** between these days.
3. **Rank Gaps** by efficiency.
4. **Select Days Off** to fill gaps.
5. **Calculate Consecutive Days Off**.
```mermaid
graph TD;
A[Start] --> B[Identify Public Holidays and Weekends]
B --> C[Find Gaps Between Days Off]
C --> D[Rank Gaps by Efficiency]
D --> E[Select Days Off to Fill Gaps]
E --> F[Calculate Consecutive Days Off]
F --> G[End]
```
## Contributing
Contributions are welcome! Open an issue or submit a pull request for improvements or new features.
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Acknowledgments
- **SvelteKit**: For the framework.
- **Vercel**: For hosting.
- **Cloudflare**: For CDN and security.
- **Cursor IDE and GPT-4o**: For development assistance.
---
**Disclaimer**: This project was 100% generated with ChatGPT out of pure interest, using a code editor designed for AI-assisted development.