This project is a web application that allows users to search for countries and retrieve detailed information about their public holidays. The app integrates a country search feature and displays holiday data using a clean and user-friendly interface.
- Search for countries by name
- View public holidays for selected countries.
- Interactive and responsive design
- Uses external APIs for real-time holiday data
- API Documentation for Countries
- API Documentation for used flags
- Frontend framework (e.g., Angular)
- Backend setup (e.g., Node.js)
- HTML, CSS, JavaScript
Follow the steps below to install and run the project on your local machine.
Before you begin, ensure you have met the following requirements:
- Node.js (v14+)
- Angular CLI (if applicable)
npm install -g @angular/cli
-
Clone the repository:
git clone https://github.com/nevskyy/country-holidays.git cd project-name -
Install dependencies:
npm install
-
Set up environment variables:
- Create a
.envfile in the root directory of the project, or use Angular'senvironment.tsfiles to store API keys, base URLs, and other environment-specific values. - Example for
.env:API_BASE_URL=https://api.example.com API_KEY=your-api-key
- Create a
-
Running the application:
- For development:
ng serve
- For production:
ng build --prod
- For development:
-
Navigate to the app: Once the application is running, open your browser and go to:
http://localhost:4200
Provide examples and instructions for how to use the application. Include details on navigating key features or any login credentials (if applicable).
List any additional libraries or frameworks used in the project, for example:
- Angular Material: For UI components
- RxJS: For handling asynchronous data streams
- Bootstrap: For responsive layout and design
If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.
This project is licensed under the MIT License - see the LICENSE file for details.