# sunset-go/multica-android architecture

> Architecture diagram of the GitHub repository sunset-go/multica-android, 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/sunset-go/multica-android
- Repository: https://github.com/sunset-go/multica-android

## Overview

Multica is a mobile Expo/React Native client for workspace collaboration and issue tracking, backed by the shared `@multica/core` business-logic package. The principal user flow is sign-in, workspace selection, then browsing or creating issues and following their activity; chat, inbox, projects, and search are major parallel capabilities. The graph separates mobile routes, core domain services, and shared infrastructure. README and indexed excerpts establish the app/core split and selected API, query, and realtime relationships; several route-to-service links are unverified because those implementations were not sampled.

Main entry points: [`apps/mobile/app/(app)/[workspace]/_layout.tsx`](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/_layout.tsx) (Workspace navigation), [`packages/core/api/client.ts`](https://github.com/sunset-go/multica-android/blob/main/packages/core/api/client.ts) (API client), [`packages/core/issues/queries.ts`](https://github.com/sunset-go/multica-android/blob/main/packages/core/issues/queries.ts) (Issue data services), [`apps/mobile/app/(auth)/login.tsx`](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(auth)/login.tsx) (Sign-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile experience"]
  node_auth["Sign-in<br/>[login.tsx]"]
  node_workspace["Workspace navigation<br/>[_layout.tsx]"]
  node_issue_ui["Issue surfaces<br/>[&#91;id&#93;.tsx]"]
  node_issue_create["Issue creation<br/>[new-issue.tsx]"]
  node_chat_ui["Chat surfaces<br/>[chat.tsx]"]
  node_inbox_ui["Inbox surfaces<br/>[inbox.tsx]"]
  node_project_ui["Project surfaces<br/>[&#91;id&#93;.tsx]"]
  node_search_ui["Search<br/>[search.tsx]"]
end

subgraph group_domains["Core domains"]
  node_issue_service["Issue data services<br/>[queries.ts]"]
  node_issue_planning["Issue query planning<br/>[query-plan.ts]"]
  node_chat_service["Chat services<br/>[queries.ts]"]
  node_inbox_service["Inbox services<br/>[queries.ts]"]
  node_project_service["Project services<br/>[queries.ts]"]
  node_domain_types["Domain types"]
end

subgraph group_platform["Shared platform"]
  node_auth_storage[("Secure auth storage<br/>[secure-storage.ts]")]
  node_workspace_state[("Workspace persistence")]
  node_schema["Response validation<br/>[schemas.ts]"]
end

subgraph group_connected["Connected services"]
  node_api["API client<br/>[client.ts]"]
  node_realtime["Realtime sync"]
  node_mobile_ws["Mobile WebSocket<br/>[ws-client.ts]"]
end

node_user(("User"))
node_backend{{"Multica backend"}}

node_user -.->|"signs in"| node_auth
node_auth -.->|"stores credentials"| node_auth_storage
node_auth -.->|"opens workspace"| node_workspace
node_workspace -.->|"sets workspace"| node_workspace_state
node_workspace -.->|"opens issues"| node_issue_ui
node_workspace -.->|"creates issues"| node_issue_create
node_workspace -.->|"opens chat"| node_chat_ui
node_workspace -.->|"opens inbox"| node_inbox_ui
node_workspace -.->|"opens projects"| node_project_ui
node_workspace -->|"opens search"| node_search_ui
node_issue_ui -.->|"loads issue data"| node_issue_service
node_issue_create -.->|"submits issue"| node_issue_service
node_issue_planning -->|"uses issue queries"| node_issue_service
node_chat_ui -.->|"loads conversations"| node_chat_service
node_inbox_ui -.->|"loads notifications"| node_inbox_service
node_project_ui -.->|"loads project data"| node_project_service
node_search_ui -.->|"queries backend"| node_api
node_issue_service -.->|"requests issue data"| node_api
node_chat_service -.->|"requests chat data"| node_api
node_inbox_service -.->|"requests inbox data"| node_api
node_project_service -.->|"requests project data"| node_api
node_api -->|"sends API requests"| node_backend
node_api -->|"validates responses"| node_schema
node_api -->|"uses domain types"| node_domain_types
node_mobile_ws -.->|"transports events"| node_realtime
node_realtime -.->|"receives live events"| node_backend

click node_auth "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(auth)/login.tsx"
click node_workspace "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/_layout.tsx"
click node_issue_ui "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/issue/%5Bid%5D.tsx"
click node_issue_create "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/new-issue.tsx"
click node_chat_ui "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/(tabs)/chat.tsx"
click node_inbox_ui "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/(tabs)/inbox.tsx"
click node_project_ui "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/project/%5Bid%5D.tsx"
click node_search_ui "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/search.tsx"
click node_issue_service "https://github.com/sunset-go/multica-android/blob/main/packages/core/issues/queries.ts"
click node_issue_planning "https://github.com/sunset-go/multica-android/blob/main/packages/core/issues/surface/query-plan.ts"
click node_chat_service "https://github.com/sunset-go/multica-android/blob/main/packages/core/chat/queries.ts"
click node_inbox_service "https://github.com/sunset-go/multica-android/blob/main/packages/core/inbox/queries.ts"
click node_project_service "https://github.com/sunset-go/multica-android/blob/main/packages/core/projects/queries.ts"
click node_domain_types "https://github.com/sunset-go/multica-android/tree/main/packages/core/types"
click node_api "https://github.com/sunset-go/multica-android/blob/main/packages/core/api/client.ts"
click node_realtime "https://github.com/sunset-go/multica-android/blob/main/packages/core/realtime/use-realtime-sync.ts"
click node_mobile_ws "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/data/realtime/ws-client.ts"
click node_auth_storage "https://github.com/sunset-go/multica-android/blob/main/apps/mobile/data/secure-storage.ts"
click node_workspace_state "https://github.com/sunset-go/multica-android/blob/main/packages/core/platform/workspace-storage.ts"
click node_schema "https://github.com/sunset-go/multica-android/blob/main/packages/core/api/schemas.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_auth,node_workspace,node_issue_ui,node_issue_create,node_chat_ui,node_inbox_ui,node_project_ui,node_search_ui,node_user toneBlue
class node_issue_service,node_issue_planning,node_chat_service,node_inbox_service,node_project_service,node_domain_types toneAmber
class node_auth_storage,node_workspace_state,node_schema toneMint
class node_api,node_realtime,node_mobile_ws toneRose
class node_backend toneIndigo
```

## Components

### Mobile experience

- [Sign-in](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(auth)/login.tsx): `apps/mobile/app/(auth)/login.tsx`
- [Workspace navigation](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/_layout.tsx): `apps/mobile/app/(app)/[workspace]/_layout.tsx`
- [Issue surfaces](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/issue/%5Bid%5D.tsx): `apps/mobile/app/(app)/[workspace]/issue/[id].tsx`
- [Issue creation](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/new-issue.tsx): `apps/mobile/app/(app)/[workspace]/new-issue.tsx`
- [Chat surfaces](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/(tabs)/chat.tsx): `apps/mobile/app/(app)/[workspace]/(tabs)/chat.tsx`
- [Inbox surfaces](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/(tabs)/inbox.tsx): `apps/mobile/app/(app)/[workspace]/(tabs)/inbox.tsx`
- [Project surfaces](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/project/%5Bid%5D.tsx): `apps/mobile/app/(app)/[workspace]/project/[id].tsx`
- [Search](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/app/(app)/%5Bworkspace%5D/search.tsx): `apps/mobile/app/(app)/[workspace]/search.tsx`

### Core domains

- [Issue data services](https://github.com/sunset-go/multica-android/blob/main/packages/core/issues/queries.ts): `packages/core/issues/queries.ts`
- [Issue query planning](https://github.com/sunset-go/multica-android/blob/main/packages/core/issues/surface/query-plan.ts): `packages/core/issues/surface/query-plan.ts`
- [Chat services](https://github.com/sunset-go/multica-android/blob/main/packages/core/chat/queries.ts): `packages/core/chat/queries.ts`
- [Inbox services](https://github.com/sunset-go/multica-android/blob/main/packages/core/inbox/queries.ts): `packages/core/inbox/queries.ts`
- [Project services](https://github.com/sunset-go/multica-android/blob/main/packages/core/projects/queries.ts): `packages/core/projects/queries.ts`
- [Domain types](https://github.com/sunset-go/multica-android/tree/main/packages/core/types): `packages/core/types`

### Shared platform

- [Secure auth storage](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/data/secure-storage.ts): `apps/mobile/data/secure-storage.ts`
- [Workspace persistence](https://github.com/sunset-go/multica-android/blob/main/packages/core/platform/workspace-storage.ts): `packages/core/platform/workspace-storage.ts`
- [Response validation](https://github.com/sunset-go/multica-android/blob/main/packages/core/api/schemas.ts): `packages/core/api/schemas.ts`

### Connected services

- [API client](https://github.com/sunset-go/multica-android/blob/main/packages/core/api/client.ts): `packages/core/api/client.ts`
- [Realtime sync](https://github.com/sunset-go/multica-android/blob/main/packages/core/realtime/use-realtime-sync.ts): `packages/core/realtime/use-realtime-sync.ts`
- [Mobile WebSocket](https://github.com/sunset-go/multica-android/blob/main/apps/mobile/data/realtime/ws-client.ts): `apps/mobile/data/realtime/ws-client.ts`

### Other components

- **User**
- **Multica backend**

## Connections

- User → Sign-in: signs in
- Sign-in → Secure auth storage: stores credentials
- Sign-in → Workspace navigation: opens workspace
- Workspace navigation → Workspace persistence: sets workspace
- Workspace navigation → Issue surfaces: opens issues
- Workspace navigation → Issue creation: creates issues
- Workspace navigation → Chat surfaces: opens chat
- Workspace navigation → Inbox surfaces: opens inbox
- Workspace navigation → Project surfaces: opens projects
- Workspace navigation → Search: opens search (evidence: `apps/mobile/app/(app)/[workspace]/search.tsx`)
- Issue surfaces → Issue data services: loads issue data
- Issue creation → Issue data services: submits issue
- Issue query planning → Issue data services: uses issue queries (evidence: `packages/core/issues/surface/query-plan.ts`)
- Chat surfaces → Chat services: loads conversations
- Inbox surfaces → Inbox services: loads notifications
- Project surfaces → Project services: loads project data
- Search → API client: queries backend
- Issue data services → API client: requests issue data
- Chat services → API client: requests chat data
- Inbox services → API client: requests inbox data
- Project services → API client: requests project data
- API client → Multica backend: sends API requests (evidence: `packages/core/api/client.ts`)
- API client → Response validation: validates responses (evidence: `packages/core/api/client.ts`)
- API client → Domain types: uses domain types (evidence: `packages/core/api/client.ts`)
- Mobile WebSocket → Realtime sync: transports events
- Realtime sync → Multica backend: receives live events
