Skip to content

renzhamin/local-lens

Repository files navigation

Overview

The main purpose of this app is to aid the user in discovering interesting places such as restaurants, schools, hospitals in a city. The user can chose to share their location and their city will be automatically detected. User can view the places in a map and also look at environmental conditions such temperature, humidity, air quality of the city. If a particular place is unlisted then the user can add this place and it will be synced with the data source. And the user can get an AI generated tour plan for a particular city.

Map view

Places are categorized as education(schools), catering(restaurants), healthcare etc. The user can view places belonging to selected set of categories in a map. There is a convenient search bar that can be used to focus on the searched place.

map.mp4

Place listing

Instead of viewing in a map, the user can see a list of places in the city with detailed information such as postcode, address line. Some weather information of the city will also be shown.

place-listing.mp4

Tour planning

This is the high level overview of the tour planning mechanism.

  1. The user will first select a city and then chose a tour nature such as a family or solo tour and the transportation system such as driving, bus, train etc.
  2. Some local attraction points, restaurants, hotels nearby will be fetched using geoapify api.
  3. The those places will be provided to an generative ai model which will output a tour plan.
tour-plan.mp4

Add a new local attraction

The user can submit a place that is unlisted. That place will be added to a private database. When places are fetched, entries from the private database will be combined with data obtained from geoapify.

add-local-attractions.mp4

Development Setup

Install packages with,

bun install

populate .env as specified in .env.example

Setup Database

  1. Start the postgres container. Make sure to populate .dockerenv.

    bun db:start
  2. Push schema changes to database.

    bun db:migrate:deploy
  3. Generate prisma definitions.

    bun db:generate

About

Find attractions nearby or in specified cities

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published