# pankaj29/space-finder architecture

> Architecture diagram of the GitHub repository pankaj29/space-finder, 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/pankaj29/space-finder
- Repository: https://github.com/pankaj29/space-finder

## Overview

Space Finder is a web app for signing in and finding or creating spaces, with optional photo uploads. The main flow runs from React screens through authenticated data services to API Gateway and Lambda CRUD handlers backed by DynamoDB; photos are uploaded separately to S3. CDK stacks define the cloud resources and connect several of them. The sampled excerpts show frontend calls and handler dispatch, but not the infrastructure’s API-to-Lambda wiring, so that connection is left unverified.

Main entry points: [`src/services/spaces/handler.ts`](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/handler.ts) (HTTP dispatcher), [`src/infra/Launcher.ts`](https://github.com/pankaj29/space-finder/blob/main/src/infra/Launcher.ts) (Stack composition), [`space-finder-frontend/src/services/DataService.ts`](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/services/DataService.ts) (Data service), [`space-finder-frontend/src/App.tsx`](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/App.tsx) (App router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web frontend"]
  node_app["App router<br/>[App.tsx]"]
  node_login["Login screen<br/>[LoginComponent.tsx]"]
  node_authclient["Auth service<br/>[AuthService.ts]"]
  node_create["Create space<br/>[CreateSpace.tsx]"]
  node_spaces["Spaces view<br/>[Spaces.tsx]"]
  node_spaceview["Space item<br/>[SpaceComponent.tsx]"]
  node_spacemodel["Space model<br/>[model.ts]"]
  node_dataservice["Data service<br/>[DataService.ts]"]
end

subgraph group_backend["Space services"]
  node_handler["HTTP dispatcher<br/>[handler.ts]"]
  node_getspaces["List spaces<br/>[GetSpaces.ts]"]
  node_postspaces["Create space<br/>[PostSpaces.ts]"]
  node_updatespace["Update space<br/>[UpdateSpace.ts]"]
  node_deletespace["Delete space<br/>[DeleteSpace.ts]"]
  node_validator["Request validation<br/>[Validator.ts]"]
  node_sharedutils["HTTP utilities<br/>[Utils.ts]"]
  node_backendmodel["Space record<br/>[Model.ts]"]
  node_monitor["Monitor handler<br/>[handler.ts]"]
  node_hello["Hello service<br/>[hello.ts]"]
end

subgraph group_cloud["Cloud resources"]
  node_apigateway["Spaces API<br/>[ApiStack.ts]"]
  node_lambda["Lambda resources<br/>[LambdaStack.ts]"]
  node_table[("Spaces table<br/>[DataStack.ts]")]
  node_photos[("Photo bucket<br/>[DataStack.ts]")]
  node_authstack["Cognito resources<br/>[AuthStack.ts]"]
  node_ui["UI deployment"]
end

subgraph group_infra["Infrastructure"]
  node_launcher["Stack composition<br/>[Launcher.ts]"]
end

node_visitor(("User"))
node_clouduser["Cognito"]
node_s3[("Amazon S3")]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_spaces
node_login -->|"signs in via"| node_authclient
node_authclient -->|"authenticates with"| node_clouduser
node_create -->|"creates through"| node_dataservice
node_spaces -->|"loads through"| node_dataservice
node_spaces -->|"renders"| node_spaceview
node_spaces -->|"uses"| node_spacemodel
node_spaceview -->|"renders"| node_spacemodel
node_dataservice -->|"gets credentials"| node_authclient
node_dataservice -.->|"sends HTTP requests"| node_apigateway
node_dataservice -->|"uploads photos"| node_s3
node_handler -->|"dispatches GET"| node_getspaces
node_handler -->|"dispatches POST"| node_postspaces
node_handler -->|"dispatches PUT"| node_updatespace
node_handler -->|"dispatches DELETE"| node_deletespace
node_handler -->|"adds CORS"| node_sharedutils
node_handler -->|"handles errors"| node_validator
node_postspaces -->|"validates with"| node_validator
node_postspaces -->|"uses"| node_sharedutils
node_deletespace -->|"uses"| node_sharedutils
node_validator -->|"validates record"| node_backendmodel
node_launcher -->|"creates via stack"| node_table
node_launcher -->|"passes table"| node_lambda
node_launcher -->|"creates"| node_authstack
node_launcher -->|"configures"| node_apigateway
node_launcher -->|"creates"| node_ui
node_launcher -->|"creates via stack"| node_photos
node_lambda -.->|"deploys"| node_handler
node_apigateway -.->|"routes to"| node_lambda
node_authstack -->|"grants upload policy"| node_photos

click node_app "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/App.tsx"
click node_login "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/LoginComponent.tsx"
click node_authclient "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/services/AuthService.ts"
click node_create "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/CreateSpace.tsx"
click node_spaces "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/Spaces.tsx"
click node_spaceview "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/SpaceComponent.tsx"
click node_spacemodel "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/model/model.ts"
click node_dataservice "https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/services/DataService.ts"
click node_apigateway "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/ApiStack.ts"
click node_lambda "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/LambdaStack.ts"
click node_handler "https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/handler.ts"
click node_getspaces "https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/GetSpaces.ts"
click node_postspaces "https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/PostSpaces.ts"
click node_updatespace "https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/UpdateSpace.ts"
click node_deletespace "https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/DeleteSpace.ts"
click node_validator "https://github.com/pankaj29/space-finder/blob/main/src/services/shared/Validator.ts"
click node_sharedutils "https://github.com/pankaj29/space-finder/blob/main/src/services/shared/Utils.ts"
click node_backendmodel "https://github.com/pankaj29/space-finder/blob/main/src/services/model/Model.ts"
click node_table "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/DataStack.ts"
click node_photos "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/DataStack.ts"
click node_authstack "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/AuthStack.ts"
click node_ui "https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/UiDeploymentStack.ts"
click node_launcher "https://github.com/pankaj29/space-finder/blob/main/src/infra/Launcher.ts"
click node_monitor "https://github.com/pankaj29/space-finder/blob/main/src/services/monitor/handler.ts"
click node_hello "https://github.com/pankaj29/space-finder/blob/main/src/services/hello.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_app,node_login,node_authclient,node_create,node_spaces,node_spaceview,node_spacemodel,node_dataservice,node_visitor toneBlue
class node_handler,node_getspaces,node_postspaces,node_updatespace,node_deletespace,node_validator,node_sharedutils,node_backendmodel,node_monitor,node_hello,node_s3 toneAmber
class node_apigateway,node_lambda,node_table,node_photos,node_authstack,node_ui toneMint
class node_launcher toneRose
class node_clouduser toneIndigo
```

## Components

### Web frontend

- [App router](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/App.tsx): `space-finder-frontend/src/App.tsx`
- [Login screen](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/LoginComponent.tsx): `space-finder-frontend/src/components/LoginComponent.tsx`
- [Auth service](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/services/AuthService.ts): `space-finder-frontend/src/services/AuthService.ts`
- [Create space](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/CreateSpace.tsx): `space-finder-frontend/src/components/spaces/CreateSpace.tsx`
- [Spaces view](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/Spaces.tsx): `space-finder-frontend/src/components/spaces/Spaces.tsx`
- [Space item](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/spaces/SpaceComponent.tsx): `space-finder-frontend/src/components/spaces/SpaceComponent.tsx`
- [Space model](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/components/model/model.ts): `space-finder-frontend/src/components/model/model.ts`
- [Data service](https://github.com/pankaj29/space-finder/blob/main/space-finder-frontend/src/services/DataService.ts): `space-finder-frontend/src/services/DataService.ts`

### Space services

- [HTTP dispatcher](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/handler.ts): `src/services/spaces/handler.ts`
- [List spaces](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/GetSpaces.ts): `src/services/spaces/GetSpaces.ts`
- [Create space](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/PostSpaces.ts): `src/services/spaces/PostSpaces.ts`
- [Update space](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/UpdateSpace.ts): `src/services/spaces/UpdateSpace.ts`
- [Delete space](https://github.com/pankaj29/space-finder/blob/main/src/services/spaces/DeleteSpace.ts): `src/services/spaces/DeleteSpace.ts`
- [Request validation](https://github.com/pankaj29/space-finder/blob/main/src/services/shared/Validator.ts): `src/services/shared/Validator.ts`
- [HTTP utilities](https://github.com/pankaj29/space-finder/blob/main/src/services/shared/Utils.ts): `src/services/shared/Utils.ts`
- [Space record](https://github.com/pankaj29/space-finder/blob/main/src/services/model/Model.ts): `src/services/model/Model.ts`
- [Monitor handler](https://github.com/pankaj29/space-finder/blob/main/src/services/monitor/handler.ts): `src/services/monitor/handler.ts`
- [Hello service](https://github.com/pankaj29/space-finder/blob/main/src/services/hello.ts): `src/services/hello.ts`

### Cloud resources

- [Spaces API](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/ApiStack.ts): `src/infra/stacks/ApiStack.ts`
- [Lambda resources](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/LambdaStack.ts): `src/infra/stacks/LambdaStack.ts`
- [Spaces table](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/DataStack.ts): `src/infra/stacks/DataStack.ts`
- [Photo bucket](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/DataStack.ts): `src/infra/stacks/DataStack.ts`
- [Cognito resources](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/AuthStack.ts): `src/infra/stacks/AuthStack.ts`
- [UI deployment](https://github.com/pankaj29/space-finder/blob/main/src/infra/stacks/UiDeploymentStack.ts): `src/infra/stacks/UiDeploymentStack.ts`

### Infrastructure

- [Stack composition](https://github.com/pankaj29/space-finder/blob/main/src/infra/Launcher.ts): `src/infra/Launcher.ts`

### Other components

- **User**
- **Cognito**
- **Amazon S3**

## Connections

- User → App router: uses
- App router → Login screen: routes to (evidence: `space-finder-frontend/src/App.tsx`)
- App router → Create space: routes to (evidence: `space-finder-frontend/src/App.tsx`)
- App router → Spaces view: routes to (evidence: `space-finder-frontend/src/App.tsx`)
- Login screen → Auth service: signs in via (evidence: `space-finder-frontend/src/components/LoginComponent.tsx`)
- Auth service → Cognito: authenticates with (evidence: `space-finder-frontend/src/services/AuthService.ts`)
- Create space → Data service: creates through (evidence: `space-finder-frontend/src/components/spaces/CreateSpace.tsx`)
- Spaces view → Data service: loads through (evidence: `space-finder-frontend/src/services/DataService.ts`)
- Spaces view → Space item: renders (evidence: `space-finder-frontend/src/components/spaces/Spaces.tsx`)
- Spaces view → Space model: uses (evidence: `space-finder-frontend/src/components/spaces/Spaces.tsx`)
- Space item → Space model: renders (evidence: `space-finder-frontend/src/components/spaces/SpaceComponent.tsx`)
- Data service → Auth service: gets credentials (evidence: `space-finder-frontend/src/services/DataService.ts`)
- Data service → Spaces API: sends HTTP requests
- Data service → Amazon S3: uploads photos (evidence: `space-finder-frontend/src/services/DataService.ts`)
- HTTP dispatcher → List spaces: dispatches GET (evidence: `src/services/spaces/handler.ts`)
- HTTP dispatcher → Create space: dispatches POST (evidence: `src/services/spaces/handler.ts`)
- HTTP dispatcher → Update space: dispatches PUT (evidence: `src/services/spaces/handler.ts`)
- HTTP dispatcher → Delete space: dispatches DELETE (evidence: `src/services/spaces/handler.ts`)
- HTTP dispatcher → HTTP utilities: adds CORS (evidence: `src/services/spaces/handler.ts`)
- HTTP dispatcher → Request validation: handles errors (evidence: `src/services/spaces/handler.ts`)
- Create space → Request validation: validates with (evidence: `src/services/spaces/PostSpaces.ts`)
- Create space → HTTP utilities: uses (evidence: `src/services/spaces/PostSpaces.ts`)
- Delete space → HTTP utilities: uses (evidence: `src/services/spaces/DeleteSpace.ts`)
- Request validation → Space record: validates record (evidence: `src/services/shared/Validator.ts`)
- Stack composition → Spaces table: creates via stack (evidence: `src/infra/Launcher.ts`)
- Stack composition → Lambda resources: passes table (evidence: `src/infra/Launcher.ts`)
- Stack composition → Cognito resources: creates (evidence: `src/infra/Launcher.ts`)
- Stack composition → Spaces API: configures (evidence: `src/infra/Launcher.ts`)
- Stack composition → UI deployment: creates (evidence: `src/infra/Launcher.ts`)
- Stack composition → Photo bucket: creates via stack (evidence: `src/infra/Launcher.ts`)
- Lambda resources → HTTP dispatcher: deploys
- Spaces API → Lambda resources: routes to
- Cognito resources → Photo bucket: grants upload policy (evidence: `src/infra/stacks/AuthStack.ts`)
