README.md

RoadWeather 🚗 🌤️

RoadWeather is a mobile application developed with React Native and TypeScript that provides users with real-time weather forecasts for multiple cities along their road trip route. By leveraging the Google Maps API and WeatherStack API, the app dynamically calculates waypoints and fetches accurate weather data to enhance trip planning and safety.

Welcome to your Expo app 👋

This is an Expo project created with create-expo-app.

In the output, you'll find options to open the app in a

• development build
• Android emulator
• iOS simulator
• Expo Go, a limited sandbox for trying out app development with Expo

Features

• Real-time weather forecasts for multiple cities along the route
• Dynamic waypoint calculation using Google Maps API
• Accurate weather data integration via WeatherStack API
• User-friendly and visually appealing interface
• Efficient API request handling for smooth, real-time updates

Installation

To get started with RoadWeather, follow these steps:

1. Clone the repository:

   git clone https://github.com/muntaqam/roadweather.git

2. Navigate to the project directory:

   cd roadweather

3. Install the dependencies:

   npm install

4. Create a .env file in the root directory and add your API keys:

   WEATHERSTACK_API_KEY=your_weatherstack_api_key
   GOOGLE_MAPS_API_KEY=your_google_maps_api_key

5. Start the development server:

   npx expo start -c

Usage

1. Open the app on your mobile device or emulator.
2. Enter your starting point and destination.
3. View real-time weather forecasts for multiple cities along your route.

Features in Progress

• Time-stamped Weather Forecasts: Display weather forecasts for cities based on the estimated time of arrival.
• Enhanced UX/UI Designs: Improve the user interface for a more seamless and intuitive experience.

Future Features

• Route Saving: Allow users to save their favorite routes for quick access in the future.
• Custom Waypoints: Allow users to add custom waypoints along their route for more detailed weather information.

Built With

• React Native - Framework for building native apps using React
• Expo - Platform for making universal React applications
• Google Maps API - API for maps and location data
• OpenWeather API - API for weather data
• react-native-bottom-sheet - Bottom sheet component for React Native

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any features, bug fixes, or enhancements.

Contact

This project was created by Muntaqa Maahi. You can find more about me on my website: https://muntaqamaahi.com/

For any questions or suggestions, feel free to contact me at munma980@gmail.com.