KS Drive

Table of Contents

• About
• Features
• Installation
• Usage
• Technologies Used
• Contributing
• License

About

KS Drive is a web application that provides real-time weather information for cities across Kosovo. The project aims to enhance safety and driving awareness by offering insights into temperature, visibility, wind conditions, and city-specific details.The app uses stack of PHP laravel for backend, MySQL for database, React with bootstrap for frontend, API REST for endpoints and data fetching from the server and Chart-js library for data projection.

Features

• Weather Awareness:

  • Stay informed with up-to-date weather data.
  • Drive confidently with insights into temperature, visibility, and wind conditions.

• City-Specific Details:

  • Explore detailed weather information for specific cities.
  • Get personalized safety recommendations based on weather conditions.

• Safety Tips:

  • Access guidance for safe driving in different weather scenarios.
  • Equip yourself with knowledge to handle challenging driving conditions.

• Responsive Design:

  • User-friendly interface that adapts to various devices.

Important

Acknowledgements OpenWeatherMap for providing the weather data API. https://www.openweathermap.org/

Installation

1. Clone the repository:

   git clone https://github.com/diellidemjaha/ksdrive.git
   

2. Navigate to the project directory:

cd ks-drive
cd react-frontend

3. Install dependencies:

npm install

Usage

4.Start the frontend development server:

npm start

5. Start the backend server on another terminal:

cd laravel-backend
php artisan serve

Open your browser and visit http://localhost:3000.

Explore the weather dashboard, city-specific details, and safety tips.

Technologies Used Laravel React React Router Bootstrap Chart.js Axios

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvement, please create an issue or submit a pull request.

License

This project is licensed under the MIT License.