Update: Refactored Source Code (#2)

WeatherMate-Mobile/README.md

@@ -30,41 +30,42 @@ These instructions will get you a copy of the project up and running on your loc
 3. **For iOS:**
     - Open the `WeatherMate.xcodeproj` file in Xcode.
     - Run the application on an iOS simulator or a physical device.
+    - Note: If you change the code, you must remove the iOS platform and add it again using the following commands for the changes to take effect:
+    ```bash
+    cordova platforms rm ios
+    cordova platforms add ios
+    ```
+
+### Mobile UI
 
-4. **For React Native:**
-    - Navigate to the project directory.
-    - Install dependencies:
-      ```bash
-      npm install
-      ```
-    - Run the app:
-      ```bash
-      npm start
-      ```
+If your previous installations are successful, you should see the following output:
 
-## Running the tests
-Explain how to run the automated tests for this system.
+#### iOS
 
-## Deployment
-Add additional notes about how to deploy this on a live system.
+<p align="center" style="cursor: pointer">
+    <img src="../utils/weathermateios.png" alt="The WeatherMate App Interface" width="80%" style="border-radius: 8px"/>
+</p>
+
+#### Android
+
+<p align="center" style="cursor: pointer">
+    <img src="../utils/weathermateandroid.png" alt="The WeatherMate App Interface" width="80%" style="border-radius: 8px"/>
+</p>
+
+This image shows an example when the user views the weather for New York City.
 
 ## Built With
 - [Kotlin](https://kotlinlang.org/) - Used for Android development.
 - [Swift](https://swift.org/) - Used for iOS development.
-- [React Native](https://reactnative.dev/) - Used for cross-platform mobile app development.
+- [Cordova](https://cordova.apache.org/) - Used for cross-platform development.
 
 ## Versioning
-We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/hoangsonww/WeatherMate-App/tags).
+We use [Git](https://git-scm.com/) for version control.
 
 ## Authors
 - **Son Nguyen Hoang** - *Initial work*
 
-See also the list of [contributors](https://github.com/hoangsonww/WeatherMate-App/contributors) who participated in this project.
+See also the list of [contributors](https://github.com/hoangsonww) who participated in this project.
 
 ## License
-This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
-
-## Acknowledgments
-- Hat tip to anyone whose code was used
-- Inspiration
-- etc
+This project is licensed under the MIT License - see the [LICENSE.md](../LICENSE) file for details.

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,47 @@
+# Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [[email protected]](mailto:[email protected]). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 1.4, available at [https://www.contributor-covenant.org/version/1/4/code-of-conduct.html](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html).
+
+For answers to common questions about this code of conduct, see [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq).
+
+---

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/CONTRIBUTING.md

@@ -0,0 +1,73 @@
+# Contributing to WeatherMate App
+
+First and foremost, thank you for considering contributing to StickyNotes App! Your time and skills are valuable to us, and we appreciate any help you can provide to make this app better for everyone. Whether you're fixing a bug, adding a new feature, or improving the documentation, your contribution is essential.
+
+## Code of Conduct
+
+Our community is dedicated to providing a harassment-free experience for everyone. We do not tolerate harassment of community members in any form. Please refer to our Code of Conduct for complete details.
+
+## Getting Started
+
+Before you begin, please ensure you have a GitHub account and have familiarized yourself with the [GitHub flow](https://guides.github.com/introduction/flow/). This will involve creating a branch, making changes, submitting a pull request, and reviewing and discussing these changes.
+
+### Reporting Bugs
+
+Bugs are tracked as GitHub issues. To report a bug, please follow these guidelines:
+
+1. **Use the GitHub issue search** to check if the issue has already been reported.
+2. If the issue is unreported, **open a new issue**. Provide a **clear title and description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
+
+### Suggesting Enhancements
+
+This section guides you through submitting an enhancement suggestion for StickyNotes App, including completely new features and minor improvements to existing functionality.
+
+1. **Use the GitHub issue search** to check if the enhancement has already been suggested.
+2. If it hasn't, **open a new issue**. Provide a **clear title and description**, as detailed as possible and if possible, include **examples** of how the enhancement would work.
+
+### Your First Code Contribution
+
+Unsure where to begin contributing to StickyNotes App? Look for the `good first issue` label in the issues section, which is a great start for newcomers.
+
+### Pull Requests
+
+1. **Fork** the repo and **create your branch** from `main`.
+2. **Make your changes** and ensure they meet the project standards.
+3. **Write or adapt tests** as needed.
+4. **Ensure your code lints** (if applicable).
+5. **Issue that pull request!**
+
+## Styleguides
+
+### Git Commit Messages
+
+- Use the present tense ("Add feature" not "Added feature").
+- Use the imperative mood ("Move cursor to..." not "Moves cursor to...").
+- Limit the first line to 72 characters or less.
+- Reference issues and pull requests liberally after the first line.
+
+### JavaScript Styleguide
+
+All JavaScript must adhere to [JavaScript Standard Style](https://standardjs.com/).
+
+### CSS/HTML Styleguide
+
+- Use soft tabs with two spaces—they're the only way to guarantee code renders the same in any environment.
+- Use HTML5 doctype (`<!DOCTYPE html>`).
+- Avoid inline styles where possible.
+
+## Additional Notes
+
+### Issue and Pull Request Labels
+
+This section lists the labels we use to help us track and manage issues and pull requests.
+
+- **`good first issue`** – Good for newcomers.
+- **`bug`** – Something isn't working.
+- **`enhancement`** – New feature or request.
+- **`help wanted`** – Extra attention is needed.
+
+## Conclusion
+
+Contributions to StickyNotes App are greatly appreciated and vital for its continuous development. By participating in this project, you agree to abide by its terms. Thank you for your contributions – happy coding!
+
+---

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/FUNDING.yml

@@ -0,0 +1,13 @@
+# These are supported funding model platforms - auto generated by GitHub
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+# Pull Request for The WeatherMate
+
+## Overview
+Briefly describe the purpose of this pull request. What features or bug fixes are included?
+
+## Related Issue/Ticket
+Link any related issue or ticket here.
+
+## Files Changed
+List the files that have been added, deleted, or modified.
+
+## Testing
+Describe how you tested these changes.
+
+## Screenshots (if applicable)
+Include screenshots or GIFs if you've made UI changes.
+
+## Notes to Reviewers
+Add any notes for reviewers, such as areas to focus on, decisions you made, etc.
+
+## Deployment Notes
+Include any necessary steps for deployment, configuration changes, etc.

WeatherMate-Mobile/platforms/android/app/src/main/assets/www/.github/README.md

@@ -0,0 +1,104 @@
+# The WeatherMate App
+
+Welcome to WeatherMate! Created by [Son Nguyen](https://github.com/hoangsonww) in 2024, WeatherMate is your go-to web application for staying updated with the latest weather conditions for any location! With an easy-to-use interface and real-time data, WeatherMate ensures that you're well-prepared for the weather ahead. The mobile version is also under development, and is in the `WeatherMate` sub-directory. At the mean time, you can use the web version at [https://hoangsonww.github.io/WeatherMate-App/](https://hoangsonww.github.io/WeatherMate-App/).
+
+## Features
+
+- **Current Weather Conditions**: Get detailed reports of the current weather, including temperature, weather conditions, and more.
+- **Local Time Display**: Shows the exact local time at the searched location.
+- **Air Quality Index (AQI)**: Stay informed about the air quality of your chosen location with the AQI feature.
+- **Humidity and Rain Forecast**: Understand the chance of precipitation and humidity levels with just a click.
+- **Dynamic Backgrounds**: The UI changes to reflect the current weather conditions, enhancing the user experience.
+- **Favorites**: Save your favorite locations for quick weather checks.
+- **Responsive Design**: WeatherMate looks great on any device, whether it's your phone, tablet, or desktop.
+
+## User Interface
+
+<p align="center" style="cursor: pointer">
+  <a href="https://hoangsonww.github.io/WeatherMate-App/">
+    <img src="../utils/weathermateUI.png" alt="The WeatherMate App Interface" width="100%"/>
+  </a>
+</p>
+
+## How It Works
+
+WeatherMate fetches data from the OpenWeatherMap API and our live databases, which provides comprehensive weather data that our app processes to give you the most relevant weather information.
+
+## Getting Started
+
+To get started with WeatherMate:
+
+1. **Clone the Repository**
+   ```bash
+   git clone https://github.com/hoangsonww/WeatherMate-App.git
+   ```
+   ```bash
+   cd WeatherMate
+   ```
+
+2. **Install Dependencies**
+   Assuming you have Node.js and npm installed, run the following command:
+   ```bash
+   npm install
+   ```
+
+3. **Run the Application**
+   Simply open the `index.html` file in your browser to see WeatherMate in action. We're also working on a mobile version, so stay tuned for updates!
+
+## Usage
+
+- **Search**: Enter a city or region name in the search box and hit enter or click the search button.
+- **View Weather**: The current weather will display immediately upon search.
+- **View Forecast**: Click the "View Forecast" button to see the upcoming weather conditions.
+- **View AQI**: Click the "View Air Quality Index" button to see the air quality data.
+- **View Humidity and Rain**: Click the "View Humidity & Chance of Rain" button to get detailed humidity stats and precipitation chances.
+- **Add to Favorites**: Click the heart icon next to the city name to add it to your favorites for quick access later.
+- **Remove from Favorites**: Click the heart icon next to the city name to remove it from your favorites.
+- **Switch Units**: Click the "Switch Units" button to toggle between Celsius and Fahrenheit.
+- **Refresh**: Click the "Refresh" button to refresh the weather data.
+- **Local Time**: The local time of the searched location is displayed at the top of the page.
+- **Dynamic Backgrounds**: The background image changes to reflect the current weather conditions.
+- **Local Advice**: The advice at the bottom of the page changes to reflect the current weather conditions.
+- **Local Weather**: The weather conditions at the top right of the page changes to reflect the current weather conditions.
+- **Cute Backgrounds**: The background image changes to reflect the current weather conditions.
+
+## Technologies
+
+- **HTML/CSS**: For structure and styling.
+- **JavaScript**: For dynamic interactions and API integration.
+- **Vue.js**: For reactive UI components.
+- **Font Awesome**: For icons.
+- **Moment.js**: For time display.
+- **jQuery**: For DOM manipulation.
+- **Bootstrap**: For styling and responsiveness.
+- **Git**: For version control.
+- **GitHub Pages**: For deployment.
+- **Webpack**: For bundling.
+- **Babel**: For transpiling.
+- **Figma**: For design and prototyping.
+
+## Contributing
+
+Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+Distributed under the MIT License. See [LICENSE](../LICENSE) for more information.
+
+## Contact
+
+Son Nguyen - [@hoangsonww](https://github.com/hoangsonww)
+
+Project Link: [https://github.com/hoangsonww/WeatherMate-App](https://github.com/hoangsonww/WeatherMate-App)
+
+App's URL: [https://hoangsonww.github.io/WeatherMate-App/](https://hoangsonww.github.io/WeatherMate-App/)
+
+---
+
+Created with ❤️ in 2024 by [Son Nguyen](https://github.com/hoangsonww). All rights reserved.