<p align="center">
    <img width="200" src="https://user-images.githubusercontent.com/58223071/221412309-ff3023c0-6d0a-4296-9879-06f8474c8e8e.png" alt="OpenMeet logo">
</p>

<p align="center">
 The <b>open-source</b> dating app you were looking for. 🤙🏻❤️
</p>

<p align="center">
<a href="#"><img src="https://img.shields.io/github/contributors/angelonazzaro/OpenMeet?style=for-the-badge" alt="Contributors"/></a>
<img src="https://img.shields.io/github/last-commit/angelonazzaro/OpenMeet?style=for-the-badge" alt="last commit">
</p>
<p align="center">
<a href="#"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=for-the-badge" alt="PRs Welcome"/></a>
<a href="#"><img src="https://img.shields.io/badge/languages-Kotlin, Java-blue?style=for-the-badge" alt="Kotlin"/></a>
</p>

<br>

# OpenMeet
<span style="font-size: 15.50px">OpenMeet</span> is a **free** and **open-source** dating app developed with the objective of giving people a platform where they can make new acquaintances and be appreciated for themselves. 

## Table of Contents 
- [How OpenMeet was born](#how-openmeet-was-born)
- [Repository Contents](#repository-contents)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [Installation guide](#installation-guide)
- [License](#license)

## How OpenMeet was born
OpenMeet was born from the idea of four college students 
to give a free, open-source, privacy-oriented and inclusive alternative to the online dating market. <br> 

### Founding Members
 - **Angelo Nazzaro** - [angelonazzaro](https://github.com/angelonazzaro/)
 - **Yuri Brandi** - [YuriBrandi](https://github.com/YuriBrandi)
 - **Roberto Della Rocca** - [robertodr01](https://github.com/robertodr01)
 - **Francesco Granozio**  - [Francesco-Granozio](https://github.com/Francesco-Granozio)

## Repository Contents
The repository is structured as follows:  
- `database`: contains scripts to create and initialize the database; 
- `mobileapp`: contains the code for the mobile app; 
- `shared`: its the backbone of the entire system; 
- `webservice`: contains the implementation of the web services which are used by the mobile app to communicate with the server; 
- `webapp`: contains the web app from which you can moderate the mobile application. 

## Documentation

 Documentation regarding the engineering process can be found in the `deliverables` folder.  <br>
  Documentation regarding the code can be found in the `javadoc` and `kdoc` folders. 

 ## Installation guide

In order to install and run the project on your local environment we recommend to follow the [installation manual](https://github.com/angelonazzaro/OpenMeet/blob/main/deliverables/openMeet_MDI.pdf). 

## Contributing
You can contribute to this software by following the guide lines specified here [Contribute](https://github.com/sl1mSha4dey/openMeet_Classe03/blob/main/contributing/CONTRIBUTING.MD).

<a href="https://github.com/angelonazzaro/OpenMeet/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=angelonazzaro/OpenMeet" />
</a>


## License
This software is distributed under the [GNU General Public License v3.0](LICENSE.md). 
