# dhiraj455/questly architecture

> Architecture diagram of the GitHub repository dhiraj455/questly, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhiraj455/questly
- Repository: https://github.com/dhiraj455/questly

## Overview

Questly appears to be a location-based exploration and social check-in app: users discover places, view them on a map, check in, and engage with friends and leaderboards. The tree shows Android features, shared data/network/location layers, and a Kotlin backend with matching domain services. No runtime source or README content was provided, so connections between these components are shown as unverified rather than asserted calls.

Main entry points: [`app/src/main/java/com/example/questly/QuestlyNavHost.kt`](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/QuestlyNavHost.kt) (Navigation), [`backend/src/main/kotlin/com/example/questly/backend/Application.kt`](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/Application.kt) (Backend API), [`core/data/src/main/java/com/example/questly/core/data/CheckInRepository.kt`](https://github.com/dhiraj455/questly/blob/master/core/data/src/main/java/com/example/questly/core/data/CheckInRepository.kt) (Check-In), [`app/src/main/java/com/example/questly/MainActivity.kt`](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/MainActivity.kt) (Questly App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android App"]
  node_android["Questly App<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[QuestlyNavHost.kt]"]
  node_authui["Auth Gate<br/>[AuthGate.kt]"]
  node_profileui["Profile Screen<br/>[ProfileScreen.kt]"]
end

subgraph group_explore["Explore And Check In"]
  node_discover["Place Discovery"]
  node_map["Quest Map<br/>[MapViewModel.kt]"]
  node_checkin["Check-In"]
  node_location["Device Location"]
end

subgraph group_social["Social Progress"]
  node_friends["Friends"]
  node_leaderboard["Leaderboard"]
  node_points["Points<br/>[PointsViewModel.kt]"]
end

subgraph group_platform["Data And Backend"]
  node_api["Questly API<br/>[QuestlyApi.kt]"]
  node_overpass["POI Lookup<br/>[OverpassClient.kt]"]
  node_localdata["Local Check-Ins"]
  node_database[("App Database<br/>[QuestlyDatabase.kt]")]
  node_backend["Backend API<br/>[Application.kt]"]
  node_authservice["Authentication<br/>[AuthService.kt]"]
  node_checkinservice["Check-In Service<br/>[CheckInService.kt]"]
  node_profileservice["Profile Service<br/>[ProfileService.kt]"]
  node_friendsservice["Friends Service<br/>[FriendsService.kt]"]
  node_leaderboardservice["Leaderboard Service<br/>[Leaderboard.kt]"]
  node_backenddb[("Backend Database<br/>[Database.kt]")]
  node_push["Push Messaging<br/>[Push.kt]"]
end

node_user(("App User"))
node_email["Email Delivery"]

node_user -.->|"uses"| node_android
node_android -.->|"opens"| node_navigation
node_navigation -.->|"routes to"| node_authui
node_navigation -.->|"routes to"| node_profileui
node_navigation -.->|"routes to"| node_discover
node_navigation -.->|"routes to"| node_map
node_navigation -.->|"routes to"| node_checkin
node_navigation -.->|"routes to"| node_friends
node_navigation -.->|"routes to"| node_leaderboard
node_navigation -.->|"routes to"| node_points
node_discover -.->|"may query"| node_overpass
node_map -.->|"may use"| node_location
node_checkin -.->|"may submit"| node_api
node_checkin -.->|"may persist"| node_localdata
node_localdata -.->|"may store"| node_database
node_api -.->|"may call"| node_backend
node_backend -.->|"may route"| node_authservice
node_backend -.->|"may route"| node_checkinservice
node_backend -.->|"may route"| node_profileservice
node_backend -.->|"may route"| node_friendsservice
node_backend -.->|"may route"| node_leaderboardservice
node_backend -.->|"may access"| node_backenddb
node_backend -.->|"may dispatch"| node_push
node_authservice -.->|"may send"| node_email

click node_android "https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/MainActivity.kt"
click node_navigation "https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/QuestlyNavHost.kt"
click node_authui "https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/AuthGate.kt"
click node_profileui "https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/ProfileScreen.kt"
click node_discover "https://github.com/dhiraj455/questly/blob/master/feature/discover/src/main/java/com/example/questly/feature/discover/DiscoverViewModel.kt"
click node_map "https://github.com/dhiraj455/questly/blob/master/feature/map/src/main/java/com/example/questly/feature/map/MapViewModel.kt"
click node_checkin "https://github.com/dhiraj455/questly/blob/master/core/data/src/main/java/com/example/questly/core/data/CheckInRepository.kt"
click node_location "https://github.com/dhiraj455/questly/blob/master/core/location/src/main/java/com/example/questly/core/location/FusedLocationProviderImpl.kt"
click node_friends "https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/FriendsViewModel.kt"
click node_leaderboard "https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/LeaderboardViewModel.kt"
click node_points "https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/PointsViewModel.kt"
click node_api "https://github.com/dhiraj455/questly/blob/master/core/network/src/main/java/com/example/questly/core/network/QuestlyApi.kt"
click node_overpass "https://github.com/dhiraj455/questly/blob/master/core/network/src/main/java/com/example/questly/core/network/OverpassClient.kt"
click node_localdata "https://github.com/dhiraj455/questly/blob/master/core/data/src/main/java/com/example/questly/core/data/LocalCheckInRepository.kt"
click node_database "https://github.com/dhiraj455/questly/blob/master/core/database/src/main/java/com/example/questly/core/database/QuestlyDatabase.kt"
click node_backend "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/Application.kt"
click node_authservice "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/auth/AuthService.kt"
click node_checkinservice "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/checkins/CheckInService.kt"
click node_profileservice "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/profile/ProfileService.kt"
click node_friendsservice "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/friends/FriendsService.kt"
click node_leaderboardservice "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/leaderboard/Leaderboard.kt"
click node_backenddb "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/Database.kt"
click node_push "https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/push/Push.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_android,node_navigation,node_authui,node_profileui,node_user toneBlue
class node_discover,node_map,node_checkin,node_location toneAmber
class node_friends,node_leaderboard,node_points toneMint
class node_api,node_overpass,node_localdata,node_database,node_backend,node_authservice,node_checkinservice,node_profileservice,node_friendsservice,node_leaderboardservice,node_backenddb,node_push toneRose
class node_email toneIndigo
```

## Components

### Android App

- [Questly App](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/MainActivity.kt): `app/src/main/java/com/example/questly/MainActivity.kt`
- [Navigation](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/QuestlyNavHost.kt): `app/src/main/java/com/example/questly/QuestlyNavHost.kt`
- [Auth Gate](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/AuthGate.kt): `app/src/main/java/com/example/questly/AuthGate.kt`
- [Profile Screen](https://github.com/dhiraj455/questly/blob/master/app/src/main/java/com/example/questly/ProfileScreen.kt): `app/src/main/java/com/example/questly/ProfileScreen.kt`

### Explore And Check In

- [Place Discovery](https://github.com/dhiraj455/questly/blob/master/feature/discover/src/main/java/com/example/questly/feature/discover/DiscoverViewModel.kt): `feature/discover/src/main/java/com/example/questly/feature/discover/DiscoverViewModel.kt`
- [Quest Map](https://github.com/dhiraj455/questly/blob/master/feature/map/src/main/java/com/example/questly/feature/map/MapViewModel.kt): `feature/map/src/main/java/com/example/questly/feature/map/MapViewModel.kt`
- [Check-In](https://github.com/dhiraj455/questly/blob/master/core/data/src/main/java/com/example/questly/core/data/CheckInRepository.kt): `core/data/src/main/java/com/example/questly/core/data/CheckInRepository.kt`
- [Device Location](https://github.com/dhiraj455/questly/blob/master/core/location/src/main/java/com/example/questly/core/location/FusedLocationProviderImpl.kt): `core/location/src/main/java/com/example/questly/core/location/FusedLocationProviderImpl.kt`

### Social Progress

- [Friends](https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/FriendsViewModel.kt): `feature/checkin/src/main/java/com/example/questly/feature/checkin/FriendsViewModel.kt`
- [Leaderboard](https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/LeaderboardViewModel.kt): `feature/checkin/src/main/java/com/example/questly/feature/checkin/LeaderboardViewModel.kt`
- [Points](https://github.com/dhiraj455/questly/blob/master/feature/checkin/src/main/java/com/example/questly/feature/checkin/PointsViewModel.kt): `feature/checkin/src/main/java/com/example/questly/feature/checkin/PointsViewModel.kt`

### Data And Backend

- [Questly API](https://github.com/dhiraj455/questly/blob/master/core/network/src/main/java/com/example/questly/core/network/QuestlyApi.kt): `core/network/src/main/java/com/example/questly/core/network/QuestlyApi.kt`
- [POI Lookup](https://github.com/dhiraj455/questly/blob/master/core/network/src/main/java/com/example/questly/core/network/OverpassClient.kt): `core/network/src/main/java/com/example/questly/core/network/OverpassClient.kt`
- [Local Check-Ins](https://github.com/dhiraj455/questly/blob/master/core/data/src/main/java/com/example/questly/core/data/LocalCheckInRepository.kt): `core/data/src/main/java/com/example/questly/core/data/LocalCheckInRepository.kt`
- [App Database](https://github.com/dhiraj455/questly/blob/master/core/database/src/main/java/com/example/questly/core/database/QuestlyDatabase.kt): `core/database/src/main/java/com/example/questly/core/database/QuestlyDatabase.kt`
- [Backend API](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/Application.kt): `backend/src/main/kotlin/com/example/questly/backend/Application.kt`
- [Authentication](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/auth/AuthService.kt): `backend/src/main/kotlin/com/example/questly/backend/auth/AuthService.kt`
- [Check-In Service](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/checkins/CheckInService.kt): `backend/src/main/kotlin/com/example/questly/backend/checkins/CheckInService.kt`
- [Profile Service](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/profile/ProfileService.kt): `backend/src/main/kotlin/com/example/questly/backend/profile/ProfileService.kt`
- [Friends Service](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/friends/FriendsService.kt): `backend/src/main/kotlin/com/example/questly/backend/friends/FriendsService.kt`
- [Leaderboard Service](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/leaderboard/Leaderboard.kt): `backend/src/main/kotlin/com/example/questly/backend/leaderboard/Leaderboard.kt`
- [Backend Database](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/Database.kt): `backend/src/main/kotlin/com/example/questly/backend/Database.kt`
- [Push Messaging](https://github.com/dhiraj455/questly/blob/master/backend/src/main/kotlin/com/example/questly/backend/push/Push.kt): `backend/src/main/kotlin/com/example/questly/backend/push/Push.kt`

### Other components

- **App User**
- **Email Delivery**

## Connections

- App User → Questly App: uses
- Questly App → Navigation: opens
- Navigation → Auth Gate: routes to
- Navigation → Profile Screen: routes to
- Navigation → Place Discovery: routes to
- Navigation → Quest Map: routes to
- Navigation → Check-In: routes to
- Navigation → Friends: routes to
- Navigation → Leaderboard: routes to
- Navigation → Points: routes to
- Place Discovery → POI Lookup: may query
- Quest Map → Device Location: may use
- Check-In → Questly API: may submit
- Check-In → Local Check-Ins: may persist
- Local Check-Ins → App Database: may store
- Questly API → Backend API: may call
- Backend API → Authentication: may route
- Backend API → Check-In Service: may route
- Backend API → Profile Service: may route
- Backend API → Friends Service: may route
- Backend API → Leaderboard Service: may route
- Backend API → Backend Database: may access
- Backend API → Push Messaging: may dispatch
- Authentication → Email Delivery: may send
