Skip to content

YahefuYusufu/PlaceKeeper

Repository files navigation

PlaceKeeper 🗺️

A modern Android application that helps users save and organize their favorite locations with custom categories and detailed information. Built with Jetpack Compose and Google Maps integration.

Features 🌟

Map Features

  • Interactive Google Maps integration
  • Multiple map types (Normal, Satellite, Terrain)
  • Custom map styles (Light/Dark themes)
  • Custom markers for different categories

Location Management

  • Save favorite locations with custom details
  • Organize places into categories
  • Add personal notes and ratings
  • Custom marker colors for different categories

Organization

  • Filter places by category
  • Search through saved locations
  • List and map view options
  • Easy category management

Tech Stack 🛠️

  • 100% Kotlin
  • Jetpack Compose
  • Material 3 Design
  • Google Maps SDK
  • Room Database
  • MVVM Architecture
  • Clean Architecture principles

Architecture 🏗️

The app follows Clean Architecture with MVVM pattern:

  • Presentation Layer (Compose UI, ViewModels)
  • Domain Layer (Use Cases, Models)
  • Data Layer (Repository, Local Database)

Screenshots 📱

[Coming soon]

Getting Started 🚀

Prerequisites

  • Android Studio Hedgehog or later
  • Minimum SDK 24
  • Google Maps API key

Setup

  1. Clone the repository
  2. Add your Google Maps API key to local.properties:
    MAPS_API_KEY=your_api_key_here

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages