Mpesa Challenge (Case Study) - Vodacom Mozambique 🇲🇿

This Laravel Atlas Application is a user-friendly web app that provides real-time weather information for various cities around the world. With this application, you can easily access weather forecasts, temperature, and other weather-related data for your favorite cities, making it an essential tool for travelers, outdoor enthusiasts, and anyone interested in staying informed about weather conditions.

How to Use

1. Open the Laravel Atlas Application in your web browser.
2. Enter the name of the city you want to check the weather for in the search box.
3. Click the "Search Now" button to view the weather information for the entered city.
4. The application will display the current temperature, weather description, and an icon representation of the weather conditions.

Whether you're planning a trip, going for a walk, or just curious about the weather, the Laravel Atlas Application is here to keep you informed. Start using it now to stay updated on weather conditions around the globe!

Table of Contents

• Project Overview
  • Features
  • Technologies Used
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Contact

Features

• Real-Time Weather Data: Get up-to-date weather information for any city by simply entering its name in the search box.
• Temperature and Weather Description: The application displays the current temperature and a description of the weather conditions.
• Responsive Design: The app is designed to work seamlessly across different devices, ensuring a great user experience on desktops, tablets, and mobile phones.
• Support for Multiple Units: Choose between Celsius and Fahrenheit to view temperature in your preferred unit.
• Population and Currency Information: In addition to weather data, the application also provides population and currency information for selected countries.

Technologies Used

• Laravel (>= 8.x) - PHP web application framework
• MySQL - Database management system
• HTML, CSS, and JavaScript - Frontend technologies
• OpenWeatherMap API - Used to fetch weather data based on city names.
• World Bank API - Used to retrieve country-specific data like population and other relevant information.
• ExchangeRateAPI - Used to fetch exchange rates based on country codes.

Getting Started

Prerequisites

Before installing the project, make sure you have the following software installed on your system:

• PHP (>= 7.4)
• Composer
• Node.js (>= 14.x)
• NPM (or Yarn)

Installation

Follow these steps to get the project up and running on your local machine:

1. Clone the repository:

https://github.com/nakatsinho/M-Assistance.git

cd M-Assistance

GOOD DJOB 🔥...

Now we have the basics to test! Note that the command above brought us the following file:

• M-Assistance/.env.example - The dummy file to clone and edit the name to .env;

Explanation and Configuration:

Be sure to run the following commands in the root directory:

composer update

And

php artisan key:generate

And Hozaaaa 🔥 🔥 🔥... "É fácil!"

Just type this on you terminal from the root of project:

php -S localhost:8030 -t public/

Open you Browser, and type http://127.0.0.1:8030 !!! ENJOY...

OR

Click here to navigate: https://bit.ly/450DLPY

Dependence & Authors

Powered by Kelton Mauro Cumbe 🇲🇿, aka The Problems Solver ! WhatsApp me any time .