README.md

LocalJobs

LocalJobs

Browse jobs and proposals close to you
Report Bug · Request Feature

Table of contents

• LocalJobs
  • Table of contents
  • About The Project
  • Getting Started
    • Prerequisites
    • Installation
  • Usage
  • Roadmap
  • Contributing
  • License
  • Contact
  • Acknowledgements

About The Project

LocalJobs is an Android application developed as project for the Embedded System course at the University of Padua during 2019. It is far from being a final product, but showcase several interesting and recent android aspects, such as:

• Kotlin
• Firebase:
  • Cloud functions
  • Cloud messaging
  • Real-time database
  • Authentication
• Jetpack
• CI from Travis
• View bindings
• Mapbox

If you are following this couse, and need to create a new project, consider to use the followings:

• Ktlint, to automatically format your kotlin code
• Travis or CirlceCI to automatically run tests, and generate apks
• Robolectric to write UI unit tests

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

You should have a working android studio setup.

Installation

1. Clone the repo

git clone https://github.com/nicomazz/LocalJobs.git
cd LocalJobs

2. Setup Firebase environment. To do that, create a new app in the Firebase console and add the generated google-services.json to /app

3. Open the project in Android Studio, and build!

Usage

• Accept permission requests:

• Browse jobs and proposals close to you:

• Send your interest to any job or proposal! If the recipient accepts your request you will be able to contact him:

• Filter jobs and proposals according with your criterias:

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be 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 GNUv3 License. See LICENSE for more information.

Contact

• Nicolo' Mazzucato - @nicomazz
• Luca Moroldo - @lucamoro
• Francesco Pham - @francescopham

Acknowledgements

• @frankplus
• @lucamoroz
• @nicomazz