Table of Contents

• About the Project
  • Built With
• Getting Started
  • Installation
  • Prerequisites
• Usage
• Notes
• Acknowledgements

About The Project

Like everywhere else in the world, many local businesses in Porto are experiencing financial difficulties during COVID-19 pandemic. Most of these stores either do not have a website, or do not offer online purchase option to their customers.

Love Local is an online marketplace for local stores aiming to support businesses in Porto which are affected by the pandemic. The web app lists stores near the user coordinates and show them on the map. User can increase or decrease the search radius and load more stores. User can also view the customized pages of the shops and access information such as contact details, payment options and reviews (ongoing project).

The deployed project can be seen here:

https://www.4local.store

Built With

• Angular 9
• Bootstrap
• Firebase
• Google Maps Web API

Getting Started

To run the project locally node.js and Angular must be installed.

Prerequisites

• Node.js
• Angular

  npm install -g @angular/cli

Installation

1. Get a free API Key at Google Maps API
2. Clone the repo

   git clone https://github.com/araskavakli/lovelocal.git

3. Change to your local ~/lovelocal/frontend directory and install NPM packages.

   npm install

4. Enter your API in src/index.html at line 31 by replacing YOUR_API_KEY with your actual API Key.

   <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places&language=en"></script>

5. Serve the project.

   ng serve

Usage

For now, the DB includes only the stores in Porto, Portugal. Therefore the Google Places API's autocomplete feature in address search bar only returns the address in and around Porto.

Users can set the search radius to load more stores.

Users can set visit customized store pages to get more information.

Notes

For easier geoquerying and faster DB connection the app has been migrated to Google Firebase. Previously the backend was built with Java. Backend dir contains the legacy backend.

Acknowledgements

• Thanks to Eray Damar from fünf Digital Design Studio, Porto for design & layout.
• Business data is acquired from Google Maps.
• All images are taken from Unsplash.