An open API service indexing awesome lists of open source software.

https://github.com/dickyrdiar/kapanlibur

countdown holiday
https://github.com/dickyrdiar/kapanlibur

holiday-planner indonesian javascript react

Last synced: 5 months ago
JSON representation

countdown holiday

Awesome Lists containing this project

README

          

# ๐Ÿ—“๏ธ KapanLibur - Holiday Countdown & Calendar

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

[![Live Demo](https://img.shields.io/badge/demo-live-green?style=for-the-badge)](https://kapanlibur.vercel.app/)
![React Version](https://img.shields.io/badge/react-18-blue.svg?style=for-the-badge&logo=react)

## ๐ŸŒŸ 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**
```bash
git clone https://github.com/your-username/kapanlibur-app.git
cd kapanlibur-app
```

2. **Install dependencies**
```bash
npm install
```

3. **Start development server**
```bash
npm run dev
```

4. **Open in browser**
```
http://localhost:3000
```

## ๐Ÿงช Running Tests
```bash
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](CONTRIBUTING.md) for details on our code standards.

## ๐Ÿ“„ License

This project is open source under the [MIT License](LICENSE).

---

**Live Demo**: [https://kapanlibur.vercel.app/](https://kapanlibur.vercel.app/)
**Report Issues**: [GitHub Issues](https://github.com/your-username/kapanlibur-app/issues)
```