HopeConnect Mobile

Let's Reach More People Together, Let's Spread More Hope Together: HopeConnect!

Explore the docs »

View Demo .

Table Of Contents

• About the Project
• Built With
• Getting Started
• Contributing
• Authors

About The Project

HopeConnect is a platform created to address urgent issues such as homelessness, hunger, and lack of education that millions of people worldwide encounter. It aims to alleviate difficulties in accessing basic necessities and provide support to those combating these problems.

Rooted in a profound sense of emotional responsibility and solidarity, HopeConnect fosters collective efforts to ensure universal basic human rights. It serves as a beacon of hope where individuals from all walks of life come together to extend a helping hand, thereby making a positive global impact.

The technology infrastructure behind HopeConnect is carefully designed to facilitate the achievement of its goals. A robust and reliable backend development utilizing ASP.NET Core 8 forms the backbone of the platform. While Microsoft SQL Server is preferred for data storage and processing, modern cloud technologies such as Google Cloud Storage and Firebase are utilized to enhance user experience and accessibility.

Through the integration of these technologies, HopeConnect aims to provide users with an easily accessible, secure, and user-friendly platform. This facilitates the swift and effective provision of support to those in need, ultimately aiming to bring about positive change and improvement on a global scale.

HopeConnect particularly focuses on the Sustainable Development Goals outlined by the United Nations, including Zero Hunger, No Poverty, and Quality Education. By targeting these goals, the platform aims to provide solutions to issues such as reducing hunger, alleviating poverty, and increasing access to education.

In the development of the mobile application, technologies such as React Native, Google Maps Platform, axios, and Asp.Net Core API have been employed. React Native accelerates development by allowing a single codebase to run on both iOS and Android platforms. The Google Maps Platform is utilized for location services, enabling users to locate nearby individuals in need and send assistance. Axios facilitates HTTP requests and communication with the server, while Asp.Net Core API manages the backend data processing and server logic.

The integration of these technologies results in a mobile application that offers a user-friendly, secure, and efficient experience. Users can easily request assistance, provide aid to those in need, and engage with other users on the platform.

Built With

Developed with HopeConnect: Empowering Change through Technology

HopeConnect is a platform designed to address urgent issues such as homelessness, hunger, and lack of education encountered by millions worldwide. The primary aim of this project is to alleviate the difficulties in accessing basic necessities and provide support to those combating these challenges. To achieve this goal, HopeConnect leverages various technologies:

React Native: React Native was used in the development of the mobile application. It provides a single codebase that can run on both iOS and Android platforms, thus accelerating the development process and reducing costs.

Google Maps Platform: The Google Maps Platform is integrated to provide users with location-based services. This allows for the visualization of aid resources on a map and facilitates users' access to nearby assistance points.

axios: The axios library is employed for making HTTP requests and communicating with the server. It manages data exchange processes and enables user interaction with the platform.

React Native Navigation: React Native Navigation is utilized for managing the user interface. It simplifies navigation within the application and enhances the user experience.

Asp.Net Core Api Integration: Asp.Net Core Api integration is implemented to manage backend data processing and server logic. It ensures secure processing and storage of user data.

Async Storage: Async Storage is used for local storage of mobile application data. It securely stores user data on the device and allows for easy access when needed.

React Native Image Picker: React Native Image Picker is integrated to enable users to select photos and media files. This simplifies the process of uploading and sharing media files within the application.

HopeConnect aims to provide users with a secure, accessible, and effective assistance platform. By integrating these technologies, we believe we are taking a significant step towards bringing about positive change and development on a global scale.

Getting Started

Welcome to HopeConnect! We're thrilled to have you onboard. Below is a guide to help you get started with our project:

1. Prerequisites Before you begin, ensure you have the following prerequisites installed on your local machine:

   • Node.js and npm: Ensure that Node.js and npm are installed on your computer. You can download and install them from the official Node.js website.

   • React Native CLI: Install the React Native CLI globally by running the following command in your terminal:

            npm install -g react-native-cli 

• Android Studio or Xcode: Depending on your target platform (Android or iOS), make sure you have either Android Studio or Xcode installed and properly configured on your system.

2. Installation Follow these steps to install and run the project locally:

• Clone the repository to your local machine:

     git clone https://github.com/your-username/hopeconnect.git

• Navigate to the project directory:

         cd hopeconnect

• Install dependencies:

          npm install

3. Running the Mobile App The mobile application part of the project is built using React Native, a framework for building native applications using JavaScript and React. To run the mobile app on your device or simulator/emulator, follow these steps:

• For iOS:

Before running the app on an iOS device or simulator, make sure you have Xcode installed on your machine.

          react-native run-ios

• For Android:

Before running the app on an Android device or emulator, make sure you have Android Studio installed and an emulator set up, or a physical Android device connected to your computer via USB debugging.

          react-native run-android

Contributing

We welcome contributions to improve and enhance HopeConnect. To contribute, follow these steps:

1. Fork the Project Fork the HopeConnect repository to your GitHub account by clicking the "Fork" button at the top-right corner of the repository page.

2. Create your Feature Branch Create a new branch for your feature using the following command:

       git checkout -b feature/YourFeatureName

3. Commit your Changes Make your desired changes to the project and commit them using the following command:

       git commit -am 'Add: Your changes here'

4. Push to the Branch Push your changes to your forked repository on GitHub using the following command:

       git push origin feature/YourFeatureName

5. Open a Pull Request Go to the GitHub page of your forked repository and click on the "New Pull Request" button. Fill out the necessary information, including a descriptive title and a summary of your changes. Once your pull request is reviewed and approved, it will be merged into the main project.

6. Code Style Guidelines Please adhere to the project's code style guidelines and conventions when making contributions. Ensure that your code is well-documented and follows best practices.

7. Issue Tracker If you encounter any bugs, issues, or have feature requests, please open an issue on the project's GitHub repository. Provide detailed information about the problem or suggestion to help us address it effectively.

8. License By contributing to HopeConnect, you agree that your contributions will be licensed under the MIT License of the project.

Authors

• Serkan Özbey Kurucu - JR. Software Developer - Serkan Özbey Kurucu - **
• Mustafa Özvardar - JR. Full Stack Software Developer - Mustafa Özvardar - **