# yizack/mappedlove architecture

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

- Interactive diagram: https://gitdiagram.com/yizack/mappedlove
- Repository: https://github.com/yizack/mappedlove

## Overview

MappedLove is a couples’ memory-mapping web app. The principal workflow is to connect partners in a bond, mark shared places, add stories and images, and optionally share a public map. Its code tree separates the map and bond interfaces from server API domains, session handling, and database schema; it also includes account recovery and premium billing capabilities. Relationships between unsampled pages and handlers are not asserted; documented product capabilities and the shown Leaflet search implementation provide the strongest evidence here.

Main entry points: [`app/components/map/MapView.vue`](https://github.com/yizack/mappedlove/blob/main/app/components/map/MapView.vue) (Map interface), [`app/pages/index.vue`](https://github.com/yizack/mappedlove/blob/main/app/pages/index.vue) (Home page), [`app/pages/app/map.vue`](https://github.com/yizack/mappedlove/blob/main/app/pages/app/map.vue) (Map page), [`app/components/bond/BondPage.vue`](https://github.com/yizack/mappedlove/blob/main/app/components/bond/BondPage.vue) (Bond interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_home["Home page<br/>[index.vue]"]
  node_appmap["Map page<br/>[map.vue]"]
  node_publicmap["Public map<br/>[&#91;code&#93;.vue]"]
end

subgraph group_journey["Shared journey"]
  node_mapview["Map interface<br/>[MapView.vue]"]
  node_markers["Markers and stories<br/>[BondMarkers.vue]"]
  node_geosearch["Location search<br/>[MapGeoSearch.vue]"]
  node_bondui["Bond interface<br/>[BondPage.vue]"]
  node_bondapi["Bond API"]
  node_markerapi["Marker API"]
end

subgraph group_accounts["Accounts and plans"]
  node_accountpages["Account pages<br/>[login.vue]"]
  node_accountapi["Account API"]
  node_billing["Premium billing"]
end

subgraph group_platform["Server platform"]
  node_dbschema["Data schema<br/>[schema.ts]"]
  node_session["Session enrichment<br/>[session.ts]"]
  node_db[("Application database")]
  node_leaflet["Leaflet plugin<br/>[leaflet.client.ts]"]
  node_siteconfig["Site configuration<br/>[site.ts]"]
end

node_couple(("Couple"))
node_paddle["Paddle"]
node_osm["OpenStreetMap search"]

node_couple -->|"discover"| node_home
node_couple -->|"connect accounts"| node_bondui
node_couple -->|"map places"| node_appmap
node_couple -->|"share memories"| node_publicmap
node_appmap -.->|"presents map"| node_mapview
node_mapview -.->|"shows markers"| node_markers
node_mapview -.->|"offers search"| node_geosearch
node_bondui -.->|"manages bond"| node_bondapi
node_mapview -.->|"manages markers"| node_markerapi
node_accountpages -.->|"handles account"| node_accountapi
node_billing -.->|"processes payments"| node_paddle
node_session -->|"reads and updates"| node_db
node_dbschema -.->|"defines tables"| node_db
node_leaflet -->|"searches locations"| node_osm
node_home -.->|"uses site identity"| node_siteconfig

click node_home "https://github.com/yizack/mappedlove/blob/main/app/pages/index.vue"
click node_appmap "https://github.com/yizack/mappedlove/blob/main/app/pages/app/map.vue"
click node_publicmap "https://github.com/yizack/mappedlove/blob/main/app/pages/map/%5Bcode%5D.vue"
click node_mapview "https://github.com/yizack/mappedlove/blob/main/app/components/map/MapView.vue"
click node_markers "https://github.com/yizack/mappedlove/blob/main/app/components/bond/BondMarkers.vue"
click node_geosearch "https://github.com/yizack/mappedlove/blob/main/app/components/map/MapGeoSearch.vue"
click node_bondui "https://github.com/yizack/mappedlove/blob/main/app/components/bond/BondPage.vue"
click node_bondapi "https://github.com/yizack/mappedlove/tree/main/server/api/bond"
click node_markerapi "https://github.com/yizack/mappedlove/tree/main/server/api/markers"
click node_accountpages "https://github.com/yizack/mappedlove/blob/main/app/pages/login.vue"
click node_accountapi "https://github.com/yizack/mappedlove/tree/main/server/api"
click node_billing "https://github.com/yizack/mappedlove/tree/main/server/api/billing"
click node_dbschema "https://github.com/yizack/mappedlove/blob/main/server/db/schema.ts"
click node_session "https://github.com/yizack/mappedlove/blob/main/server/plugins/session.ts"
click node_leaflet "https://github.com/yizack/mappedlove/blob/main/app/plugins/leaflet.client.ts"
click node_siteconfig "https://github.com/yizack/mappedlove/blob/main/shared/utils/site.ts"

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_home,node_appmap,node_publicmap toneBlue
class node_mapview,node_markers,node_geosearch,node_bondui,node_bondapi,node_markerapi toneAmber
class node_accountpages,node_accountapi,node_billing toneMint
class node_dbschema,node_session,node_db,node_leaflet,node_siteconfig toneRose
class node_couple,node_paddle,node_osm toneIndigo
```

## Components

### Web experience

- [Home page](https://github.com/yizack/mappedlove/blob/main/app/pages/index.vue): `app/pages/index.vue`
- [Map page](https://github.com/yizack/mappedlove/blob/main/app/pages/app/map.vue): `app/pages/app/map.vue`
- [Public map](https://github.com/yizack/mappedlove/blob/main/app/pages/map/%5Bcode%5D.vue): `app/pages/map/[code].vue`

### Shared journey

- [Map interface](https://github.com/yizack/mappedlove/blob/main/app/components/map/MapView.vue): `app/components/map/MapView.vue`
- [Markers and stories](https://github.com/yizack/mappedlove/blob/main/app/components/bond/BondMarkers.vue): `app/components/bond/BondMarkers.vue`
- [Location search](https://github.com/yizack/mappedlove/blob/main/app/components/map/MapGeoSearch.vue): `app/components/map/MapGeoSearch.vue`
- [Bond interface](https://github.com/yizack/mappedlove/blob/main/app/components/bond/BondPage.vue): `app/components/bond/BondPage.vue`
- [Bond API](https://github.com/yizack/mappedlove/tree/main/server/api/bond): `server/api/bond`
- [Marker API](https://github.com/yizack/mappedlove/tree/main/server/api/markers): `server/api/markers`

### Accounts and plans

- [Account pages](https://github.com/yizack/mappedlove/blob/main/app/pages/login.vue): `app/pages/login.vue`
- [Account API](https://github.com/yizack/mappedlove/tree/main/server/api): `server/api`
- [Premium billing](https://github.com/yizack/mappedlove/tree/main/server/api/billing): `server/api/billing`

### Server platform

- [Data schema](https://github.com/yizack/mappedlove/blob/main/server/db/schema.ts): `server/db/schema.ts`
- [Session enrichment](https://github.com/yizack/mappedlove/blob/main/server/plugins/session.ts): `server/plugins/session.ts`
- **Application database**
- [Leaflet plugin](https://github.com/yizack/mappedlove/blob/main/app/plugins/leaflet.client.ts): `app/plugins/leaflet.client.ts`
- [Site configuration](https://github.com/yizack/mappedlove/blob/main/shared/utils/site.ts): `shared/utils/site.ts`

### Other components

- **Couple**
- **Paddle**
- **OpenStreetMap search**

## Connections

- Couple → Home page: discover
- Couple → Bond interface: connect accounts
- Couple → Map page: map places
- Couple → Public map: share memories
- Map page → Map interface: presents map
- Map interface → Markers and stories: shows markers
- Map interface → Location search: offers search
- Bond interface → Bond API: manages bond
- Map interface → Marker API: manages markers
- Account pages → Account API: handles account
- Premium billing → Paddle: processes payments
- Session enrichment → Application database: reads and updates (evidence: `server/plugins/session.ts`)
- Data schema → Application database: defines tables
- Leaflet plugin → OpenStreetMap search: searches locations (evidence: `app/plugins/leaflet.client.ts`)
- Home page → Site configuration: uses site identity
