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: 3 months 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 (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-10T13:36:27.000Z (about 2 years ago)
- Last Synced: 2025-02-10T00:34:41.666Z (over 1 year 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
## 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.