How byanski/fluxoid works
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: App.tsx Fluxer app · channel Messaging interface · IpcHandlers.tsx Desktop shell · useTextareaExpressionHandlers.tsx Message expressions
Components 18
Client experience
- Desktop shell
fluxer_desktop/src/main/IpcHandlers.tsx - Fluxer app
fluxer_app/src/App.tsx - Login and token auth
fluxer_app/src/components/auth - Messaging interface
fluxer_app/src/components/channel - Message expressions
fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx - Message scrolling
fluxer_app/src/lib/ScrollManager.tsx - Incoming calls
fluxer_app/src/components/voice/IncomingCallManager.tsx - Theming settings
fluxer_app/src
Fluxer services
- API service
fluxer_api/src/App.tsx - API middleware
packages/api/src/app/MiddlewarePipeline.tsx - Message retrieval
packages/api/src/channel/services/message/MessageRetrievalService.tsx
Media and storage
- Media proxy
packages/media_proxy/src/App.tsx - Image handling
packages/media_proxy/src/controllers/ImageController.tsx - Direct S3 storage
packages/api/src/infrastructure/DirectS3StorageService.tsx
Supporting systems
- Job queue
packages/queue/src/engine/QueueEngine.tsx - Admin console
packages/admin/src/App.tsx - Caddy static serving
Other components
- Client user
Connections 13
- 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
fluxer_app/src/hooks/useTextareaExpressionHandlers.tsx - Message scrolling → Messaging interface: fetches messages
fluxer_app/src/lib/ScrollManager.tsx - API service → API middleware: configures middleware
- Media proxy → Image handling: handles image routes