# byanski/fluxoid architecture

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

## Overview

Fluxoid is a theming- and developer-oriented fork of Fluxer, delivered as a desktop client backed by Fluxer’s API and gateway. The principal workflow is opening the client, authenticating (including the documented token-login option), and using the messaging client; themers can customize appearance and behavior through CSS and JavaScript settings. The repository also contains substantial backend services for message retrieval, media, and queued work. Backend internals and several documented capabilities were not fully sampled, so their links are omitted rather than inferred.

Main entry points: [`fluxer_app/src/App.tsx`](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/App.tsx) (Fluxer app), [`fluxer_app/src/components/channel`](https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src/components/channel) (Messaging interface), [`fluxer_desktop/src/main/IpcHandlers.tsx`](https://github.com/byanski/fluxoid/blob/refactor/fluxer_desktop/src/main/IpcHandlers.tsx) (Desktop shell), [`fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx`](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx) (Message expressions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_desktop["Desktop shell<br/>[IpcHandlers.tsx]"]
  node_webapp["Fluxer app<br/>[App.tsx]"]
  node_auth["Login and token auth"]
  node_messageui["Messaging interface"]
  node_expression["Message expressions"]
  node_scroll["Message scrolling<br/>[ScrollManager.tsx]"]
  node_voice["Incoming calls"]
  node_customize["Theming settings"]
end

subgraph group_services["Fluxer services"]
  node_apiapp["API service<br/>[App.tsx]"]
  node_middleware["API middleware"]
  node_retrieval["Message retrieval"]
end

subgraph group_media["Media and storage"]
  node_mediasvc["Media proxy<br/>[App.tsx]"]
  node_image["Image handling"]
  node_directs3["Direct S3 storage"]
end

subgraph group_platform["Supporting systems"]
  node_queue["Job queue<br/>[QueueEngine.tsx]"]
  node_admin["Admin console<br/>[App.tsx]"]
  node_caddy["Caddy static serving"]
end

node_user(("Client user"))

node_user -->|"launches"| node_desktop
node_desktop -.->|"opens client"| node_webapp
node_user -->|"authenticates"| node_auth
node_webapp -.->|"presents login"| node_auth
node_user -->|"uses messaging"| node_messageui
node_user -->|"customizes client"| node_customize
node_caddy -->|"serves static assets"| node_webapp
node_webapp -->|"routes API requests"| node_apiapp
node_messageui -.->|"handles selections"| node_expression
node_expression -->|"sends message"| node_messageui
node_scroll -->|"fetches messages"| node_messageui
node_apiapp -.->|"configures middleware"| node_middleware
node_mediasvc -.->|"handles image routes"| node_image

click node_desktop "https://github.com/byanski/fluxoid/blob/refactor/fluxer_desktop/src/main/IpcHandlers.tsx"
click node_webapp "https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/App.tsx"
click node_auth "https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src/components/auth"
click node_messageui "https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src/components/channel"
click node_expression "https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx"
click node_scroll "https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/lib/ScrollManager.tsx"
click node_voice "https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/components/voice/IncomingCallManager.tsx"
click node_customize "https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src"
click node_apiapp "https://github.com/byanski/fluxoid/blob/refactor/fluxer_api/src/App.tsx"
click node_middleware "https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/app/MiddlewarePipeline.tsx"
click node_retrieval "https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/channel/services/message/MessageRetrievalService.tsx"
click node_mediasvc "https://github.com/byanski/fluxoid/blob/refactor/packages/media_proxy/src/App.tsx"
click node_image "https://github.com/byanski/fluxoid/blob/refactor/packages/media_proxy/src/controllers/ImageController.tsx"
click node_directs3 "https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/infrastructure/DirectS3StorageService.tsx"
click node_queue "https://github.com/byanski/fluxoid/blob/refactor/packages/queue/src/engine/QueueEngine.tsx"
click node_admin "https://github.com/byanski/fluxoid/blob/refactor/packages/admin/src/App.tsx"

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_desktop,node_webapp,node_auth,node_messageui,node_expression,node_scroll,node_voice,node_customize,node_user toneBlue
class node_apiapp,node_middleware,node_retrieval toneAmber
class node_mediasvc,node_image,node_directs3 toneMint
class node_queue,node_admin,node_caddy toneRose
```

## Components

### Client experience

- [Desktop shell](https://github.com/byanski/fluxoid/blob/refactor/fluxer_desktop/src/main/IpcHandlers.tsx): `fluxer_desktop/src/main/IpcHandlers.tsx`
- [Fluxer app](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/App.tsx): `fluxer_app/src/App.tsx`
- [Login and token auth](https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src/components/auth): `fluxer_app/src/components/auth`
- [Messaging interface](https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src/components/channel): `fluxer_app/src/components/channel`
- [Message expressions](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx): `fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx`
- [Message scrolling](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/lib/ScrollManager.tsx): `fluxer_app/src/lib/ScrollManager.tsx`
- [Incoming calls](https://github.com/byanski/fluxoid/blob/refactor/fluxer_app/src/components/voice/IncomingCallManager.tsx): `fluxer_app/src/components/voice/IncomingCallManager.tsx`
- [Theming settings](https://github.com/byanski/fluxoid/tree/refactor/fluxer_app/src): `fluxer_app/src`

### Fluxer services

- [API service](https://github.com/byanski/fluxoid/blob/refactor/fluxer_api/src/App.tsx): `fluxer_api/src/App.tsx`
- [API middleware](https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/app/MiddlewarePipeline.tsx): `packages/api/src/app/MiddlewarePipeline.tsx`
- [Message retrieval](https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/channel/services/message/MessageRetrievalService.tsx): `packages/api/src/channel/services/message/MessageRetrievalService.tsx`

### Media and storage

- [Media proxy](https://github.com/byanski/fluxoid/blob/refactor/packages/media_proxy/src/App.tsx): `packages/media_proxy/src/App.tsx`
- [Image handling](https://github.com/byanski/fluxoid/blob/refactor/packages/media_proxy/src/controllers/ImageController.tsx): `packages/media_proxy/src/controllers/ImageController.tsx`
- [Direct S3 storage](https://github.com/byanski/fluxoid/blob/refactor/packages/api/src/infrastructure/DirectS3StorageService.tsx): `packages/api/src/infrastructure/DirectS3StorageService.tsx`

### Supporting systems

- [Job queue](https://github.com/byanski/fluxoid/blob/refactor/packages/queue/src/engine/QueueEngine.tsx): `packages/queue/src/engine/QueueEngine.tsx`
- [Admin console](https://github.com/byanski/fluxoid/blob/refactor/packages/admin/src/App.tsx): `packages/admin/src/App.tsx`
- **Caddy static serving**

### Other components

- **Client user**

## Connections

- Client user → Desktop shell: launches
- Desktop shell → Fluxer app: opens client
- Client user → Login and token auth: authenticates
- Fluxer app → Login and token auth: presents login
- Client user → Messaging interface: uses messaging
- Client user → Theming settings: customizes client
- Caddy static serving → Fluxer app: serves static assets
- Fluxer app → API service: routes API requests
- Messaging interface → Message expressions: handles selections
- Message expressions → Messaging interface: sends message (evidence: `fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx`)
- Message scrolling → Messaging interface: fetches messages (evidence: `fluxer_app/src/lib/ScrollManager.tsx`)
- API service → API middleware: configures middleware
- Media proxy → Image handling: handles image routes
