# zve-rev/dating-app architecture

> Architecture diagram of the GitHub repository zve-rev/dating-app, 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/zve-rev/dating-app
- Repository: https://github.com/zve-rev/dating-app

## Overview

Iskra is a dating and social-discovery application. A user signs up through email verification, creates a profile, browses and likes profiles, reviews received likes, and chats with matches. The frontend routes these experiences through a shared API client to a Spring backend; backend services and repositories implement the corresponding domain areas. Frontend routing and several API calls are visible in the excerpts. Backend internals are represented from the file tree only, so their relationships are omitted where they cannot be verified.

Main entry points: [`frontend/src/api.js`](https://github.com/zve-rev/dating-app/blob/main/frontend/src/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/zve-rev/dating-app/blob/main/frontend/src/App.jsx) (Route app), [`frontend/src/profile/CreateProfile.jsx`](https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/CreateProfile.jsx) (Profile creation), [`frontend/src/swipes/Swipes.jsx`](https://github.com/zve-rev/dating-app/blob/main/frontend/src/swipes/Swipes.jsx) (Profile discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Route app<br/>[App.jsx]"]
  node_landing["Landing page<br/>[Landing.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_signup["Sign-up flow<br/>[SignUp.jsx]"]
  node_login["Sign-in flow<br/>[SignIn.jsx]"]
  node_email["Email verification"]
  node_login_backend["Login backend"]
  node_profile_create["Profile creation<br/>[CreateProfile.jsx]"]
  node_profile_form["Profile form<br/>[ProfileForm.jsx]"]
  node_profile_preview["Profile preview<br/>[ProfilePreview.jsx]"]
  node_profile_view["Profile management<br/>[Profile.jsx]"]
  node_profile_backend["Profile backend"]
end

subgraph group_discovery["Discovery and likes"]
  node_swipes["Profile discovery<br/>[Swipes.jsx]"]
  node_profile_card["Profile card<br/>[ProfileCard.jsx]"]
  node_swipe_backend["Swipe backend"]
  node_likes["Received likes<br/>[Likes.jsx]"]
  node_like_backend["Like backend"]
end

subgraph group_messaging["Messaging"]
  node_chat["Chat experience<br/>[Chat.jsx]"]
  node_chat_backend["Chat backend"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_profile_create
node_app -->|"routes to"| node_profile_view
node_app -->|"routes to"| node_swipes
node_app -->|"routes to"| node_likes
node_app -->|"routes to"| node_chat
node_signup -->|"requests verification"| node_api
node_api -->|"HTTP requests"| node_email
node_login -->|"authenticates via"| node_api
node_api -.->|"HTTP requests"| node_login_backend
node_profile_create -->|"renders"| node_profile_form
node_profile_create -->|"renders"| node_profile_preview
node_profile_view -->|"loads and updates"| node_api
node_profile_view -.->|"HTTP requests"| node_profile_backend
node_profile_create -->|"submits profile"| node_api
node_swipes -->|"renders"| node_profile_card
node_swipes -->|"loads profiles"| node_api
node_swipes -.->|"HTTP requests"| node_swipe_backend
node_likes -->|"loads and responds"| node_api
node_likes -.->|"HTTP requests"| node_like_backend
node_chat -->|"loads and sends"| node_api
node_chat -->|"renders"| node_navbar
node_api -.->|"HTTP and event stream"| node_chat_backend
node_navbar -->|"checks unread count"| node_api

click node_app "https://github.com/zve-rev/dating-app/blob/main/frontend/src/App.jsx"
click node_landing "https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/Landing.jsx"
click node_navbar "https://github.com/zve-rev/dating-app/blob/main/frontend/src/components/Navbar.jsx"
click node_api "https://github.com/zve-rev/dating-app/blob/main/frontend/src/api.js"
click node_signup "https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/SignUp.jsx"
click node_login "https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/SignIn.jsx"
click node_email "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/email/EmailCodeController.java"
click node_login_backend "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/login/LoginController.java"
click node_profile_create "https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/CreateProfile.jsx"
click node_profile_form "https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/ProfileForm.jsx"
click node_profile_preview "https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/ProfilePreview.jsx"
click node_profile_view "https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/Profile.jsx"
click node_profile_backend "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/profile/ProfileController.java"
click node_swipes "https://github.com/zve-rev/dating-app/blob/main/frontend/src/swipes/Swipes.jsx"
click node_profile_card "https://github.com/zve-rev/dating-app/blob/main/frontend/src/swipes/ProfileCard.jsx"
click node_swipe_backend "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/swipe/SwipeController.java"
click node_likes "https://github.com/zve-rev/dating-app/blob/main/frontend/src/likes/Likes.jsx"
click node_like_backend "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/like/LikeController.java"
click node_chat "https://github.com/zve-rev/dating-app/blob/main/frontend/src/chat/Chat.jsx"
click node_chat_backend "https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/chat/ChatController.java"

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_landing,node_navbar,node_api,node_user toneBlue
class node_signup,node_login,node_email,node_login_backend,node_profile_create,node_profile_form,node_profile_preview,node_profile_view,node_profile_backend toneAmber
class node_swipes,node_profile_card,node_swipe_backend,node_likes,node_like_backend toneMint
class node_chat,node_chat_backend toneRose
```

## Components

### Web experience

- [Route app](https://github.com/zve-rev/dating-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Landing page](https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/Landing.jsx): `frontend/src/pages/Landing.jsx`
- [Navigation](https://github.com/zve-rev/dating-app/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [API client](https://github.com/zve-rev/dating-app/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Identity and profiles

- [Sign-up flow](https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/SignUp.jsx): `frontend/src/pages/SignUp.jsx`
- [Sign-in flow](https://github.com/zve-rev/dating-app/blob/main/frontend/src/pages/SignIn.jsx): `frontend/src/pages/SignIn.jsx`
- [Email verification](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/email/EmailCodeController.java): `backend/src/main/java/com/example/demo/email/EmailCodeController.java`
- [Login backend](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/login/LoginController.java): `backend/src/main/java/com/example/demo/login/LoginController.java`
- [Profile creation](https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/CreateProfile.jsx): `frontend/src/profile/CreateProfile.jsx`
- [Profile form](https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/ProfileForm.jsx): `frontend/src/profile/ProfileForm.jsx`
- [Profile preview](https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/ProfilePreview.jsx): `frontend/src/profile/ProfilePreview.jsx`
- [Profile management](https://github.com/zve-rev/dating-app/blob/main/frontend/src/profile/Profile.jsx): `frontend/src/profile/Profile.jsx`
- [Profile backend](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/profile/ProfileController.java): `backend/src/main/java/com/example/demo/profile/ProfileController.java`

### Discovery and likes

- [Profile discovery](https://github.com/zve-rev/dating-app/blob/main/frontend/src/swipes/Swipes.jsx): `frontend/src/swipes/Swipes.jsx`
- [Profile card](https://github.com/zve-rev/dating-app/blob/main/frontend/src/swipes/ProfileCard.jsx): `frontend/src/swipes/ProfileCard.jsx`
- [Swipe backend](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/swipe/SwipeController.java): `backend/src/main/java/com/example/demo/swipe/SwipeController.java`
- [Received likes](https://github.com/zve-rev/dating-app/blob/main/frontend/src/likes/Likes.jsx): `frontend/src/likes/Likes.jsx`
- [Like backend](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/like/LikeController.java): `backend/src/main/java/com/example/demo/like/LikeController.java`

### Messaging

- [Chat experience](https://github.com/zve-rev/dating-app/blob/main/frontend/src/chat/Chat.jsx): `frontend/src/chat/Chat.jsx`
- [Chat backend](https://github.com/zve-rev/dating-app/blob/main/backend/src/main/java/com/example/demo/chat/ChatController.java): `backend/src/main/java/com/example/demo/chat/ChatController.java`

### Other components

- **User**

## Connections

- User → Route app: uses
- Route app → Landing page: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Sign-up flow: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Sign-in flow: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Profile creation: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Profile management: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Profile discovery: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Received likes: routes to (evidence: `frontend/src/App.jsx`)
- Route app → Chat experience: routes to (evidence: `frontend/src/App.jsx`)
- Sign-up flow → API client: requests verification (evidence: `frontend/src/pages/SignUp.jsx`)
- API client → Email verification: HTTP requests (evidence: `frontend/src/api.js`)
- Sign-in flow → API client: authenticates via (evidence: `frontend/src/pages/SignIn.jsx`)
- API client → Login backend: HTTP requests
- Profile creation → Profile form: renders (evidence: `frontend/src/profile/CreateProfile.jsx`)
- Profile creation → Profile preview: renders (evidence: `frontend/src/profile/CreateProfile.jsx`)
- Profile management → API client: loads and updates (evidence: `frontend/src/profile/Profile.jsx`)
- Profile management → Profile backend: HTTP requests
- Profile creation → API client: submits profile (evidence: `frontend/src/profile/CreateProfile.jsx`)
- Profile discovery → Profile card: renders (evidence: `frontend/src/swipes/Swipes.jsx`)
- Profile discovery → API client: loads profiles (evidence: `frontend/src/swipes/Swipes.jsx`)
- Profile discovery → Swipe backend: HTTP requests
- Received likes → API client: loads and responds (evidence: `frontend/src/likes/Likes.jsx`)
- Received likes → Like backend: HTTP requests
- Chat experience → API client: loads and sends (evidence: `frontend/src/chat/Chat.jsx`)
- Chat experience → Navigation: renders (evidence: `frontend/src/chat/Chat.jsx`)
- API client → Chat backend: HTTP and event stream
- Navigation → API client: checks unread count (evidence: `frontend/src/components/Navbar.jsx`)
