# kaitlyn-tran/idxexchange architecture

> Architecture diagram of the GitHub repository kaitlyn-tran/idxexchange, 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/kaitlyn-tran/idxexchange
- Repository: https://github.com/kaitlyn-tran/idxexchange

## Overview

IDX Exchange is a property-search application. Users filter, sort, and page through listings, then open a listing for its details, photos, map, and open-house schedule. The browser pages call the Express API; its property routes query MySQL for listing and open-house data. The graph includes the health check and the listing/detail presentation components documented by the source index. Several component implementations were not excerpted, so only their documented page-to-component relationships are shown; no external map or image service integration is inferred.

Main entry points: [`frontend/src/pages/ListingsPage.js`](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/ListingsPage.js) (Listing search page), [`frontend/src/pages/PropertyDetailPage.js`](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/PropertyDetailPage.js) (Property detail page), [`frontend/src/api/client.js`](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/api/client.js) (API client), [`backend/routes/properties.js`](https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/routes/properties.js) (Property endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Routes and error boundary<br/>[App.js]"]
  node_listings["Listing search page<br/>[ListingsPage.js]"]
  node_filters["Search filters<br/>[PropertyFilters.js]"]
  node_sorting["Sort controls<br/>[SortControls.js]"]
  node_pagination["Pagination<br/>[Pagination.js]"]
  node_cards["Property cards<br/>[PropertyCard.js]"]
  node_detail["Property detail page"]
  node_gallery["Photo gallery"]
  node_map["Property map<br/>[PropertyMap.js]"]
  node_openhouses["Open house list<br/>[OpenHouseList.js]"]
end

subgraph group_api["API and services"]
  node_client["API client<br/>[client.js]"]
  node_server["Express server<br/>[server.js]"]
  node_health["Database health<br/>[health.js]"]
  node_properties["Property endpoints<br/>[properties.js]"]
end

subgraph group_data["Property data"]
  node_pool["MySQL connection pool<br/>[db.js]"]
  node_mysql[("MySQL database")]
end

node_homebuyer(("Homebuyer"))

node_homebuyer -->|"uses"| node_app
node_app -->|"routes to"| node_listings
node_app -->|"routes to"| node_detail
node_listings -->|"renders"| node_filters
node_listings -->|"renders"| node_sorting
node_listings -->|"renders"| node_pagination
node_listings -->|"renders"| node_cards
node_listings -->|"fetches listings"| node_client
node_detail -->|"fetches details"| node_client
node_detail -->|"renders"| node_gallery
node_detail -->|"renders"| node_map
node_detail -->|"renders"| node_openhouses
node_client -->|"requests listings"| node_properties
node_client -->|"requests details"| node_properties
node_server -->|"mounts route"| node_health
node_server -->|"mounts route"| node_properties
node_health -->|"checks connection"| node_pool
node_properties -->|"queries listings"| node_pool
node_pool -.->|"connects"| node_mysql
node_client -->|"requests open houses"| node_properties

click node_app "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/App.js"
click node_listings "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/ListingsPage.js"
click node_filters "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyFilters.js"
click node_sorting "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/SortControls.js"
click node_pagination "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/Pagination.js"
click node_cards "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyCard.js"
click node_detail "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/PropertyDetailPage.js"
click node_gallery "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyImageGallery.js"
click node_map "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyMap.js"
click node_openhouses "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/OpenHouseList.js"
click node_client "https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/api/client.js"
click node_server "https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/server.js"
click node_health "https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/routes/health.js"
click node_properties "https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/routes/properties.js"
click node_pool "https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/config/db.js"

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_app,node_listings,node_filters,node_sorting,node_pagination,node_cards,node_detail,node_gallery,node_map,node_openhouses toneBlue
class node_client,node_server,node_health,node_properties toneAmber
class node_pool,node_mysql toneMint
class node_homebuyer toneIndigo
```

## Components

### Web experience

- [Routes and error boundary](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Listing search page](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/ListingsPage.js): `frontend/src/pages/ListingsPage.js`
- [Search filters](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyFilters.js): `frontend/src/components/PropertyFilters.js`
- [Sort controls](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/SortControls.js): `frontend/src/components/SortControls.js`
- [Pagination](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/Pagination.js): `frontend/src/components/Pagination.js`
- [Property cards](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyCard.js): `frontend/src/components/PropertyCard.js`
- [Property detail page](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/pages/PropertyDetailPage.js): `frontend/src/pages/PropertyDetailPage.js`
- [Photo gallery](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyImageGallery.js): `frontend/src/components/PropertyImageGallery.js`
- [Property map](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/PropertyMap.js): `frontend/src/components/PropertyMap.js`
- [Open house list](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/components/OpenHouseList.js): `frontend/src/components/OpenHouseList.js`

### API and services

- [API client](https://github.com/kaitlyn-tran/idxexchange/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Express server](https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/server.js): `backend/server.js`
- [Database health](https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/routes/health.js): `backend/routes/health.js`
- [Property endpoints](https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/routes/properties.js): `backend/routes/properties.js`

### Property data

- [MySQL connection pool](https://github.com/kaitlyn-tran/idxexchange/blob/main/backend/config/db.js): `backend/config/db.js`
- **MySQL database**

### Other components

- **Homebuyer**

## Connections

- Homebuyer → Routes and error boundary: uses (evidence: `README.md`)
- Routes and error boundary → Listing search page: routes to (evidence: `frontend/src/App.js`)
- Routes and error boundary → Property detail page: routes to (evidence: `frontend/src/App.js`)
- Listing search page → Search filters: renders (evidence: `frontend/src/pages/ListingsPage.js`)
- Listing search page → Sort controls: renders (evidence: `frontend/src/pages/ListingsPage.js`)
- Listing search page → Pagination: renders (evidence: `frontend/src/pages/ListingsPage.js`)
- Listing search page → Property cards: renders (evidence: `frontend/src/pages/ListingsPage.js`)
- Listing search page → API client: fetches listings (evidence: `frontend/src/pages/ListingsPage.js`)
- Property detail page → API client: fetches details (evidence: `frontend/src/pages/PropertyDetailPage.js`)
- Property detail page → Photo gallery: renders (evidence: `frontend/src/pages/PropertyDetailPage.js`)
- Property detail page → Property map: renders (evidence: `frontend/src/pages/PropertyDetailPage.js`)
- Property detail page → Open house list: renders (evidence: `frontend/src/pages/PropertyDetailPage.js`)
- API client → Property endpoints: requests listings (evidence: `README.md`)
- API client → Property endpoints: requests details (evidence: `README.md`)
- Express server → Database health: mounts route (evidence: `backend/server.js`)
- Express server → Property endpoints: mounts route (evidence: `backend/server.js`)
- Database health → MySQL connection pool: checks connection (evidence: `backend/routes/health.js`)
- Property endpoints → MySQL connection pool: queries listings (evidence: `backend/routes/properties.js`)
- MySQL connection pool → MySQL database: connects
- API client → Property endpoints: requests open houses (evidence: `README.md`)
