Weather Forecasting Web App
Project Overview
Welcome to the Weather Forecasting Web App project! This application empowers users to access real-time weather information and temperature details for any city. Leveraging the OpenWeatherMap API, the project showcases a responsive and intuitive interface. Built with Node.js on the backend, EJS for templating, and vanilla JavaScript for the frontend, it's a simple yet effective tool for staying updated on weather conditions.
Features
- Dynamic Data: Fetches current weather data from OpenWeatherMap API.
- User-Friendly Interface: Displays current temperature, min/max temperature, and weather icon.
- Responsive Design: Ensures a seamless experience across various screen sizes.
Contribution Guidelines (JWOC)
Thank you for considering contributing to our project as part of JGEC Winter of Code (JWOC)! We appreciate your enthusiasm. Follow these additional steps to make your contribution journey smoother:
-
Create or Identify an Existing Issue:
- Browse through existing issues or create a new one if you identify an area for improvement or a bug. Provide a brief explanation of the issue to guide potential contributors.
-
Get Assigned to the Issue by Mentor:
- Express your interest in working on a specific issue by commenting on it. A mentor will review your comment and assign the issue to you if it's available. This ensures clear ownership and coordination.
-
Fork the Repository:
- Fork the project repository to your GitHub account.
-
Clone the Repository:
- Clone your forked repository to your local machine using the
git clone
command.
-
Make Changes:
- Implement necessary changes or enhancements to the codebase.
-
Create a Pull Request (PR):
- Submit a Pull Request to the main repository, providing a clear explanation of the changes made.
-
Communication:
- Engage with the community and project maintainers on the designated communication channels.
Getting Started
To run the Weather Forecasting Web App locally, follow these user-friendly steps:
-
Install Node.js:
- Make sure you have Node.js installed on your machine.
-
Install Dependencies:
- Run
npm install
in the project root directory to install required packages.
-
Start the Server:
- Execute
node index.js
to launch the server.
-
Access the App:
- Open your web browser and go to
http://localhost:8000
to explore the application.
Additional Information
- The project structure is neatly organized, with distinct folders for frontend (public), views, and backend (index.js).
- Frontend styling resides in
public/home.css
, while dynamic behavior is implemented in public/home.js
.
- Contributions are not only welcomed but celebrated. Refer to the contribution guidelines for a smooth process.
- If you have questions or need clarifications, don't hesitate to reach out to the project maintainers.
Enjoy your journey of contributing to the Weather Forecasting Web App as part of JGEC Winter of Code!
Contribute for JWoC-2k24