🗓️ KapanLibur - Holiday Countdown & Calendar

A web application for tracking holidays and special dates with countdown timers. Built with React.js and modern web technologies.

🌟 Features

• 📅 Comprehensive holiday calendar
• ⏳ Countdown timer to upcoming holidays
• 🔍 Search/filter holidays by name
• 🏷️ Categorization of national vs non-national holidays
• 📱 Fully responsive design
• 🧪 Unit testing with Jest

🛠 Tech Stack

• Frontend:
  • React 18 (Functional Components + Hooks)
  • JavaScript (ES6+)
  • Axios for HTTP requests
• Testing:
  • Jest
  • React Testing Library
• Build:
  • Vite (or create-react-app if applicable)
• Hosting:
  • Vercel (for demo deployment)

🚀 Getting Started

Follow these instructions to set up the project locally:

1. Clone the repository

   git clone https://github.com/your-username/kapanlibur-app.git
   cd kapanlibur-app

2. Install dependencies

   npm install

3. Start development server

   npm run dev

4. Open in browser

   http://localhost:3000
   

🧪 Running Tests

npm test

🤝 Contributing

We welcome contributions! Here's how to help:

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

Please read CONTRIBUTING.md for details on our code standards.

📄 License

This project is open source under the MIT License.

---

Live Demo: https://kapanlibur.vercel.app/
Report Issues: GitHub Issues