# misskey-dev/misskey architecture

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

- Interactive diagram: https://gitdiagram.com/misskey-dev/misskey
- Repository: https://github.com/misskey-dev/misskey

## Overview

Misskey is a federated social platform. Its broad user workflow is to use the web client to access server capabilities, with the backend handling social and federation operations and the JavaScript package providing a typed API surface. The sampled evidence directly supports only a few internal calls; broader product relationships are documented at a high level in the README, so those links are intentionally limited. The tree shows additional capabilities such as games, service-worker behavior, and diagnostics, but their runtime connections were not sampled.

Main entry points: [`packages/backend/src/MainModule.ts`](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/MainModule.ts) (Backend application), [`packages/misskey-js/src/api.types.ts`](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/api.types.ts) (Endpoint types), [`packages/frontend/src`](https://github.com/misskey-dev/misskey/tree/develop/packages/frontend/src) (Web interface), [`packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue`](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue) (Local emoji grid)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Web interface"]
  node_emoji_page["Emoji management"]
  node_emoji_local["Local emoji grid"]
  node_emoji_helpers["Emoji helpers"]
  node_emoji_search["Emoji search"]
  node_preferences["Preference manager<br/>[manager.ts]"]
  node_preference_defs["Preference definitions<br/>[def.ts]"]
end

subgraph group_server["Backend services"]
  node_backend["Backend application<br/>[MainModule.ts]"]
  node_query["Query service<br/>[QueryService.ts]"]
  node_oauth["OAuth provider"]
  node_auth["API authentication"]
  node_log_manager["Log manager<br/>[LogManager.ts]"]
  node_log_normalizer["Log normalization<br/>[LogNormalizer.ts]"]
end

subgraph group_federation["Federation"]
  node_delivery["ActivityPub delivery"]
end

subgraph group_sdk["API client"]
  node_api["API client<br/>[api.ts]"]
  node_api_types["Endpoint types<br/>[api.types.ts]"]
  node_api_docs["Generated API methods<br/>[apiClientJSDoc.ts]"]
  node_endpoint_defs["Generated endpoints<br/>[endpoint.ts]"]
  node_entities["Generated entities<br/>[entities.ts]"]
  node_models["Generated models<br/>[models.ts]"]
  node_entity_types["Entity types<br/>[entities.ts]"]
end

node_user(("Platform user"))

node_user -->|"uses"| node_web
node_web -.->|"accesses"| node_backend
node_backend -.->|"serves"| node_user
node_web -->|"offers"| node_emoji_page
node_emoji_page -->|"renders"| node_emoji_local
node_emoji_local -->|"uses"| node_emoji_helpers
node_emoji_local -->|"renders"| node_emoji_search
node_preferences -->|"reads definitions"| node_preference_defs
node_api -->|"augmented by"| node_api_docs
node_api -->|"types requests"| node_api_types
node_api_types -->|"uses endpoints"| node_endpoint_defs
node_api_types -->|"uses models"| node_models
node_api_types -->|"uses entities"| node_entities
node_api_types -->|"uses types"| node_entity_types
node_log_manager -->|"normalizes logs"| node_log_normalizer
node_backend -.->|"federates activity"| node_delivery
node_backend -.->|"queries platform data"| node_query
node_backend -.->|"provides authorization"| node_oauth
node_backend -.->|"authenticates API"| node_auth

click node_web "https://github.com/misskey-dev/misskey/tree/develop/packages/frontend/src"
click node_emoji_page "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/custom-emojis-manager.vue"
click node_emoji_local "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue"
click node_emoji_helpers "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.impl.ts"
click node_emoji_search "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.local.list.search.vue"
click node_preferences "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/preferences/manager.ts"
click node_preference_defs "https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/preferences/def.ts"
click node_backend "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/MainModule.ts"
click node_query "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/QueryService.ts"
click node_oauth "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/server/oauth/OAuth2ProviderService.ts"
click node_auth "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/server/api/AuthenticateService.ts"
click node_delivery "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/activitypub/ApDeliverManagerService.ts"
click node_log_manager "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/logging/LogManager.ts"
click node_log_normalizer "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/logging/LogNormalizer.ts"
click node_api "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/api.ts"
click node_api_types "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/api.types.ts"
click node_api_docs "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/apiClientJSDoc.ts"
click node_endpoint_defs "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/endpoint.ts"
click node_entities "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/entities.ts"
click node_models "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/models.ts"
click node_entity_types "https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/entities.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_web,node_emoji_page,node_emoji_local,node_emoji_helpers,node_emoji_search,node_preferences,node_preference_defs,node_user toneBlue
class node_backend,node_query,node_oauth,node_auth,node_log_manager,node_log_normalizer toneAmber
class node_delivery toneMint
class node_api,node_api_types,node_api_docs,node_endpoint_defs,node_entities,node_models,node_entity_types toneRose
```

## Components

### Web client

- [Web interface](https://github.com/misskey-dev/misskey/tree/develop/packages/frontend/src): `packages/frontend/src`
- [Emoji management](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/custom-emojis-manager.vue): `packages/frontend/src/pages/custom-emojis-manager.vue`
- [Local emoji grid](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue): `packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue`
- [Emoji helpers](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.impl.ts): `packages/frontend/src/pages/admin/custom-emojis-manager.impl.ts`
- [Emoji search](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/pages/admin/custom-emojis-manager.local.list.search.vue): `packages/frontend/src/pages/admin/custom-emojis-manager.local.list.search.vue`
- [Preference manager](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/preferences/manager.ts): `packages/frontend/src/preferences/manager.ts`
- [Preference definitions](https://github.com/misskey-dev/misskey/blob/develop/packages/frontend/src/preferences/def.ts): `packages/frontend/src/preferences/def.ts`

### Backend services

- [Backend application](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/MainModule.ts): `packages/backend/src/MainModule.ts`
- [Query service](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/QueryService.ts): `packages/backend/src/core/QueryService.ts`
- [OAuth provider](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/server/oauth/OAuth2ProviderService.ts): `packages/backend/src/server/oauth/OAuth2ProviderService.ts`
- [API authentication](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/server/api/AuthenticateService.ts): `packages/backend/src/server/api/AuthenticateService.ts`
- [Log manager](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/logging/LogManager.ts): `packages/backend/src/logging/LogManager.ts`
- [Log normalization](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/logging/LogNormalizer.ts): `packages/backend/src/logging/LogNormalizer.ts`

### Federation

- [ActivityPub delivery](https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/activitypub/ApDeliverManagerService.ts): `packages/backend/src/core/activitypub/ApDeliverManagerService.ts`

### API client

- [API client](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/api.ts): `packages/misskey-js/src/api.ts`
- [Endpoint types](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/api.types.ts): `packages/misskey-js/src/api.types.ts`
- [Generated API methods](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/apiClientJSDoc.ts): `packages/misskey-js/src/autogen/apiClientJSDoc.ts`
- [Generated endpoints](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/endpoint.ts): `packages/misskey-js/src/autogen/endpoint.ts`
- [Generated entities](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/entities.ts): `packages/misskey-js/src/autogen/entities.ts`
- [Generated models](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/autogen/models.ts): `packages/misskey-js/src/autogen/models.ts`
- [Entity types](https://github.com/misskey-dev/misskey/blob/develop/packages/misskey-js/src/entities.ts): `packages/misskey-js/src/entities.ts`

### Other components

- **Platform user**

## Connections

- Platform user → Web interface: uses (evidence: `README.md`)
- Web interface → Backend application: accesses
- Backend application → Platform user: serves
- Web interface → Emoji management: offers (evidence: `packages/frontend/src/pages/custom-emojis-manager.vue`)
- Emoji management → Local emoji grid: renders (evidence: `packages/frontend/src/pages/custom-emojis-manager.vue`)
- Local emoji grid → Emoji helpers: uses (evidence: `packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue`)
- Local emoji grid → Emoji search: renders (evidence: `packages/frontend/src/pages/admin/custom-emojis-manager.local.list.vue`)
- Preference manager → Preference definitions: reads definitions (evidence: `packages/frontend/src/preferences/manager.ts`)
- API client → Generated API methods: augmented by (evidence: `packages/misskey-js/src/autogen/apiClientJSDoc.ts`)
- API client → Endpoint types: types requests (evidence: `packages/misskey-js/src/api.ts`)
- Endpoint types → Generated endpoints: uses endpoints (evidence: `packages/misskey-js/src/api.types.ts`)
- Endpoint types → Generated models: uses models (evidence: `packages/misskey-js/src/api.types.ts`)
- Endpoint types → Generated entities: uses entities (evidence: `packages/misskey-js/src/api.types.ts`)
- Endpoint types → Entity types: uses types (evidence: `packages/misskey-js/src/api.types.ts`)
- Log manager → Log normalization: normalizes logs (evidence: `packages/backend/src/logging/LogManager.ts`)
- Backend application → ActivityPub delivery: federates activity
- Backend application → Query service: queries platform data
- Backend application → OAuth provider: provides authorization
- Backend application → API authentication: authenticates API
