Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/diellidemjaha/ksdrive

KS Drive is a web application built on Laravel and React, that provides real-time weather information for cities across Kosovo.
https://github.com/diellidemjaha/ksdrive

api-rest bootstrap5 chartjs-2 laravel openweathermap-api reactjs

Last synced: 16 days ago
JSON representation

KS Drive is a web application built on Laravel and React, that provides real-time weather information for cities across Kosovo.

Host: GitHub
URL: https://github.com/diellidemjaha/ksdrive
Owner: diellidemjaha
Created: 2024-01-22T11:25:40.000Z (12 months ago)
Default Branch: main
Last Pushed: 2024-06-10T13:36:27.000Z (7 months ago)
Last Synced: 2024-06-10T15:34:19.365Z (7 months ago)
Topics: api-rest, bootstrap5, chartjs-2, laravel, openweathermap-api, reactjs
Language: PHP
Homepage:
Size: 10.7 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# KS Drive

![KS Drive Screenshot 1](/scrnshot1.png)

![KS Drive Screenshot 2](/scrnshot2.png)

![KS Drive Screenshot 3](/scrnshot3.png)

## Table of Contents

- [About](#about)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#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:

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

2. Navigate to the project directory:

```bash
cd ks-drive
cd react-frontend
```

3. Install dependencies:

```bash
npm install
```

Usage

4.Start the frontend development server:

```bash
npm start
```

5. Start the backend server on another terminal:

```bash
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.