# catchchat/yep architecture

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

- Interactive diagram: https://gitdiagram.com/catchchat/yep
- Repository: https://github.com/catchchat/yep

## Overview

Yep is an iOS social app for helping people find experts and learners by domain, then connect through profiles, feeds, and messaging. A user enters the app, discovers people or skills, views profiles and feeds, and can start conversations or publish a feed; the README also documents account, social-information, media, location, and sharing capabilities. The map combines documented service responsibilities with source-index references and sampled calls; unsampled feature internals are represented at their existing directories, and their precise runtime wiring is not inferred.

Main entry points: [`Yep/ViewControllers/NewFeed/NewFeedViewController.swift`](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/NewFeed/NewFeedViewController.swift) (Create feed), [`YepKit/Remote/YepService.swift`](https://github.com/catchchat/yep/blob/master/YepKit/Remote/YepService.swift) (Account and API), [`Yep/ViewControllers/Discover`](https://github.com/catchchat/yep/tree/master/Yep/ViewControllers/Discover) (Discover people), [`Yep/ViewControllers/Conversation/ConversationViewController.swift`](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Conversation/ConversationViewController.swift) (Conversations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app_entry["App entry<br/>[AppDelegate.swift]"]
end

subgraph group_connect["Discovery and connection"]
  node_discover["Discover people"]
  node_profile["User profiles"]
  node_feeds["Browse feeds"]
  node_compose["Create feed"]
  node_conversation["Conversations"]
  node_chat["Chat interface"]
end

subgraph group_services["Services and data"]
  node_remote["Account and API<br/>[YepService.swift]"]
  node_sync["Sync operations"]
  node_network["HTTP and JSON"]
  node_realm[("Local persistence<br/>[Models.swift]")]
  node_defaults[("User preferences")]
  node_realtime["Realtime messaging"]
  node_social["Social profiles"]
  node_open_graph["Link metadata<br/>[Service.swift]"]
  node_location["Location service"]
end

subgraph group_media["Media and sharing"]
  node_cache["Image cache<br/>[ImageCache.swift]"]
  node_downloader["Media downloads"]
  node_preview["Photo preview"]
  node_share["Share extension"]
  node_storage["Cloud storage"]
end

node_user(("User"))
node_external_services(("Remote services"))

node_user -.->|"opens"| node_app_entry
node_discover -.->|"opens profile"| node_profile
node_user -.->|"finds experts"| node_discover
node_user -.->|"browses feeds"| node_feeds
node_user -.->|"publishes feed"| node_compose
node_user -.->|"starts conversation"| node_conversation
node_conversation -->|"shows messages"| node_chat
node_compose -->|"fetches metadata"| node_open_graph
node_compose -->|"uses location"| node_location
node_compose -.->|"uploads media"| node_storage
node_conversation -.->|"receives updates"| node_realtime
node_discover -.->|"loads users"| node_remote
node_profile -.->|"loads social info"| node_social
node_remote -->|"sends requests"| node_network
node_sync -.->|"sends requests"| node_network
node_remote -->|"reads credentials"| node_defaults
node_defaults -->|"updates user model"| node_realm
node_feeds -.->|"uses cached images"| node_cache
node_cache -->|"downloads images"| node_downloader
node_chat -->|"presents photos"| node_preview
node_share -->|"creates shared feed"| node_remote
node_share -.->|"uploads attachments"| node_storage
node_network -.->|"calls APIs"| node_external_services
node_storage -.->|"stores media"| node_external_services

click node_app_entry "https://github.com/catchchat/yep/blob/master/Yep/AppDelegate.swift"
click node_discover "https://github.com/catchchat/yep/tree/master/Yep/ViewControllers/Discover"
click node_profile "https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Profile/ProfileViewController.swift"
click node_feeds "https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Feeds/FeedsViewController.swift"
click node_compose "https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/NewFeed/NewFeedViewController.swift"
click node_conversation "https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Conversation/ConversationViewController.swift"
click node_chat "https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Chat/ChatViewController.swift"
click node_remote "https://github.com/catchchat/yep/blob/master/YepKit/Remote/YepService.swift"
click node_sync "https://github.com/catchchat/yep/blob/master/YepKit/Remote/YepServiceSync.swift"
click node_network "https://github.com/catchchat/yep/blob/master/YepNetworking/YepNetworking.swift"
click node_realm "https://github.com/catchchat/yep/blob/master/YepKit/Persistence/Models.swift"
click node_defaults "https://github.com/catchchat/yep/blob/master/YepKit/UserDefaults/YepUserDefaults.swift"
click node_realtime "https://github.com/catchchat/yep/blob/master/Yep/Services/YepFayeService.swift"
click node_social "https://github.com/catchchat/yep/blob/master/YepKit/Remote/SocialWorkService.swift"
click node_open_graph "https://github.com/catchchat/yep/blob/master/OpenGraph/Service.swift"
click node_location "https://github.com/catchchat/yep/blob/master/Yep/Services/YepLocationService.swift"
click node_cache "https://github.com/catchchat/yep/blob/master/Yep/Caches/ImageCache.swift"
click node_downloader "https://github.com/catchchat/yep/blob/master/Yep/Services/YepDownloader.swift"
click node_preview "https://github.com/catchchat/yep/blob/master/YepPreview/PhotosViewController.swift"
click node_share "https://github.com/catchchat/yep/blob/master/YepShare/ShareViewController.swift"
click node_storage "https://github.com/catchchat/yep/blob/master/Yep/Services/YepStorageService.swift"

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_entry,node_user toneBlue
class node_discover,node_profile,node_feeds,node_compose,node_conversation,node_chat toneAmber
class node_remote,node_sync,node_network,node_realm,node_defaults,node_realtime,node_social,node_open_graph,node_location toneMint
class node_cache,node_downloader,node_preview,node_share,node_storage toneRose
class node_external_services toneIndigo
```

## Components

### App experience

- [App entry](https://github.com/catchchat/yep/blob/master/Yep/AppDelegate.swift): `Yep/AppDelegate.swift`

### Discovery and connection

- [Discover people](https://github.com/catchchat/yep/tree/master/Yep/ViewControllers/Discover): `Yep/ViewControllers/Discover`
- [User profiles](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Profile/ProfileViewController.swift): `Yep/ViewControllers/Profile/ProfileViewController.swift`
- [Browse feeds](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Feeds/FeedsViewController.swift): `Yep/ViewControllers/Feeds/FeedsViewController.swift`
- [Create feed](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/NewFeed/NewFeedViewController.swift): `Yep/ViewControllers/NewFeed/NewFeedViewController.swift`
- [Conversations](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Conversation/ConversationViewController.swift): `Yep/ViewControllers/Conversation/ConversationViewController.swift`
- [Chat interface](https://github.com/catchchat/yep/blob/master/Yep/ViewControllers/Chat/ChatViewController.swift): `Yep/ViewControllers/Chat/ChatViewController.swift`

### Services and data

- [Account and API](https://github.com/catchchat/yep/blob/master/YepKit/Remote/YepService.swift): `YepKit/Remote/YepService.swift`
- [Sync operations](https://github.com/catchchat/yep/blob/master/YepKit/Remote/YepServiceSync.swift): `YepKit/Remote/YepServiceSync.swift`
- [HTTP and JSON](https://github.com/catchchat/yep/blob/master/YepNetworking/YepNetworking.swift): `YepNetworking/YepNetworking.swift`
- [Local persistence](https://github.com/catchchat/yep/blob/master/YepKit/Persistence/Models.swift): `YepKit/Persistence/Models.swift`
- [User preferences](https://github.com/catchchat/yep/blob/master/YepKit/UserDefaults/YepUserDefaults.swift): `YepKit/UserDefaults/YepUserDefaults.swift`
- [Realtime messaging](https://github.com/catchchat/yep/blob/master/Yep/Services/YepFayeService.swift): `Yep/Services/YepFayeService.swift`
- [Social profiles](https://github.com/catchchat/yep/blob/master/YepKit/Remote/SocialWorkService.swift): `YepKit/Remote/SocialWorkService.swift`
- [Link metadata](https://github.com/catchchat/yep/blob/master/OpenGraph/Service.swift): `OpenGraph/Service.swift`
- [Location service](https://github.com/catchchat/yep/blob/master/Yep/Services/YepLocationService.swift): `Yep/Services/YepLocationService.swift`

### Media and sharing

- [Image cache](https://github.com/catchchat/yep/blob/master/Yep/Caches/ImageCache.swift): `Yep/Caches/ImageCache.swift`
- [Media downloads](https://github.com/catchchat/yep/blob/master/Yep/Services/YepDownloader.swift): `Yep/Services/YepDownloader.swift`
- [Photo preview](https://github.com/catchchat/yep/blob/master/YepPreview/PhotosViewController.swift): `YepPreview/PhotosViewController.swift`
- [Share extension](https://github.com/catchchat/yep/blob/master/YepShare/ShareViewController.swift): `YepShare/ShareViewController.swift`
- [Cloud storage](https://github.com/catchchat/yep/blob/master/Yep/Services/YepStorageService.swift): `Yep/Services/YepStorageService.swift`

### Other components

- **User**
- **Remote services**

## Connections

- User → App entry: opens
- Discover people → User profiles: opens profile
- User → Discover people: finds experts (evidence: `README.md`)
- User → Browse feeds: browses feeds
- User → Create feed: publishes feed
- User → Conversations: starts conversation
- Conversations → Chat interface: shows messages (evidence: `Yep/ViewControllers/Conversation/ConversationViewController.swift`)
- Create feed → Link metadata: fetches metadata (evidence: `Yep/ViewControllers/NewFeed/NewFeedViewController.swift`)
- Create feed → Location service: uses location (evidence: `Yep/ViewControllers/NewFeed/NewFeedViewController.swift`)
- Create feed → Cloud storage: uploads media
- Conversations → Realtime messaging: receives updates (evidence: `Yep/ViewControllers/Conversation/ConversationViewController.swift`)
- Discover people → Account and API: loads users
- User profiles → Social profiles: loads social info (evidence: `README.md`)
- Account and API → HTTP and JSON: sends requests (evidence: `YepKit/Remote/YepService.swift`)
- Sync operations → HTTP and JSON: sends requests (evidence: `README.md`)
- Account and API → User preferences: reads credentials (evidence: `YepKit/Remote/YepService.swift`)
- User preferences → Local persistence: updates user model (evidence: `YepKit/UserDefaults/YepUserDefaults.swift`)
- Browse feeds → Image cache: uses cached images
- Image cache → Media downloads: downloads images (evidence: `Yep/Caches/ImageCache.swift`)
- Chat interface → Photo preview: presents photos (evidence: `Yep/ViewControllers/Chat/ChatViewController+Preview.swift`)
- Share extension → Account and API: creates shared feed (evidence: `YepShare/ShareViewController.swift`)
- Share extension → Cloud storage: uploads attachments
- HTTP and JSON → Remote services: calls APIs (evidence: `README.md`)
- Cloud storage → Remote services: stores media (evidence: `README.md`)
