# cyko-design/kaneo-dash architecture

> Architecture diagram of the GitHub repository cyko-design/kaneo-dash, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyko-design/kaneo-dash
- Repository: https://github.com/cyko-design/kaneo-dash

## Overview

Kaneo is a team project-management product. People use its web or mobile clients, CLI, and MCP integration to work with shared projects and tasks; the API also supports collaboration, workflow customization, notifications, and external integrations. The sampled web entry point mounts the router, and an admin route excerpt shows routing into user-management controllers. Most feature implementations were not sampled, so their subsystem paths come from the repository tree and documented capabilities; links not directly evidenced are omitted.

Main entry points: [`apps/api/src/openapi.ts`](https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/openapi.ts) (REST API), [`apps/web/src/main.tsx`](https://github.com/cyko-design/kaneo-dash/blob/main/apps/web/src/main.tsx) (Web app), [`apps/mobile/src`](https://github.com/cyko-design/kaneo-dash/tree/main/apps/mobile/src) (Mobile app), [`packages/cli/src/main.ts`](https://github.com/cyko-design/kaneo-dash/blob/main/packages/cli/src/main.ts) (Command-line client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Product clients"]
  node_web["Web app<br/>[main.tsx]"]
  node_mobile["Mobile app"]
  node_cli["Command-line client<br/>[main.ts]"]
  node_mcp["MCP server<br/>[server.ts]"]
end

subgraph group_api["API and administration"]
  node_api_entry["REST API<br/>[openapi.ts]"]
  node_admin["Admin operations"]
  node_database[("Application database<br/>[schema.ts]")]
  node_storage[("Object storage<br/>[s3.ts]")]
  node_billing["Subscriptions"]
end

subgraph group_work["Project work"]
  node_projects["Projects and tasks"]
  node_workflow["Columns and fields"]
  node_collaboration["Team collaboration"]
  node_notifications["Notifications"]
end

subgraph group_connections["Integrations and delivery"]
  node_github["GitHub integration"]
  node_gitea["Gitea integration"]
  node_chat["Chat integrations"]
  node_webhooks["Webhooks"]
  node_import["Project import"]
end

node_team(("Team members"))

node_team -->|"uses"| node_web
node_team -->|"uses"| node_mobile
node_team -->|"uses"| node_cli
node_team -->|"connects through"| node_mcp
node_web -.->|"calls API"| node_api_entry
node_mobile -.->|"calls API"| node_api_entry
node_cli -->|"uses REST API"| node_api_entry
node_mcp -->|"uses REST API"| node_api_entry
node_api_entry -->|"routes requests"| node_admin
node_admin -->|"reads and writes"| node_database
node_api_entry -.->|"serves task work"| node_projects
node_api_entry -->|"supports customization"| node_workflow
node_api_entry -->|"supports collaboration"| node_collaboration
node_api_entry -->|"delivers notifications"| node_notifications
node_api_entry -.->|"supports subscriptions"| node_billing
node_api_entry -->|"connects repositories"| node_github
node_api_entry -->|"connects repositories"| node_gitea
node_api_entry -->|"connects chat"| node_chat
node_api_entry -->|"supports webhooks"| node_webhooks
node_api_entry -.->|"supports imports"| node_import
node_api_entry -.->|"stores attachments"| node_storage

click node_web "https://github.com/cyko-design/kaneo-dash/blob/main/apps/web/src/main.tsx"
click node_mobile "https://github.com/cyko-design/kaneo-dash/tree/main/apps/mobile/src"
click node_cli "https://github.com/cyko-design/kaneo-dash/blob/main/packages/cli/src/main.ts"
click node_mcp "https://github.com/cyko-design/kaneo-dash/blob/main/packages/mcp/src/server.ts"
click node_api_entry "https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/openapi.ts"
click node_admin "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/admin"
click node_database "https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/database/schema.ts"
click node_storage "https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/storage/s3.ts"
click node_projects "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/task"
click node_workflow "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/column"
click node_collaboration "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/activity"
click node_notifications "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/notification"
click node_billing "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/billing"
click node_github "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/github-integration"
click node_gitea "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/gitea-integration"
click node_chat "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/discord-integration"
click node_webhooks "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/admin/webhooks"
click node_import "https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/import"

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_mobile,node_cli,node_mcp toneBlue
class node_api_entry,node_admin,node_database,node_storage,node_billing toneAmber
class node_projects,node_workflow,node_collaboration,node_notifications toneMint
class node_github,node_gitea,node_chat,node_webhooks,node_import toneRose
class node_team toneIndigo
```

## Components

### Product clients

- [Web app](https://github.com/cyko-design/kaneo-dash/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`
- [Mobile app](https://github.com/cyko-design/kaneo-dash/tree/main/apps/mobile/src): `apps/mobile/src`
- [Command-line client](https://github.com/cyko-design/kaneo-dash/blob/main/packages/cli/src/main.ts): `packages/cli/src/main.ts`
- [MCP server](https://github.com/cyko-design/kaneo-dash/blob/main/packages/mcp/src/server.ts): `packages/mcp/src/server.ts`

### API and administration

- [REST API](https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/openapi.ts): `apps/api/src/openapi.ts`
- [Admin operations](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/admin): `apps/api/src/admin`
- [Application database](https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/database/schema.ts): `apps/api/src/database/schema.ts`
- [Object storage](https://github.com/cyko-design/kaneo-dash/blob/main/apps/api/src/storage/s3.ts): `apps/api/src/storage/s3.ts`
- [Subscriptions](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/billing): `apps/api/src/billing`

### Project work

- [Projects and tasks](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/task): `apps/api/src/task`
- [Columns and fields](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/column): `apps/api/src/column`
- [Team collaboration](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/activity): `apps/api/src/activity`
- [Notifications](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/notification): `apps/api/src/notification`

### Integrations and delivery

- [GitHub integration](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/github-integration): `apps/api/src/github-integration`
- [Gitea integration](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/gitea-integration): `apps/api/src/gitea-integration`
- [Chat integrations](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/discord-integration): `apps/api/src/discord-integration`
- [Webhooks](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/admin/webhooks): `apps/api/src/admin/webhooks`
- [Project import](https://github.com/cyko-design/kaneo-dash/tree/main/apps/api/src/import): `apps/api/src/import`

### Other components

- **Team members**

## Connections

- Team members → Web app: uses
- Team members → Mobile app: uses
- Team members → Command-line client: uses
- Team members → MCP server: connects through
- Web app → REST API: calls API
- Mobile app → REST API: calls API
- Command-line client → REST API: uses REST API
- MCP server → REST API: uses REST API
- REST API → Admin operations: routes requests (evidence: `apps/api/src/admin/user-routes.ts`)
- Admin operations → Application database: reads and writes (evidence: `apps/api/src/admin/controllers/create-user.ts`)
- REST API → Projects and tasks: serves task work
- REST API → Columns and fields: supports customization
- REST API → Team collaboration: supports collaboration
- REST API → Notifications: delivers notifications
- REST API → Subscriptions: supports subscriptions
- REST API → GitHub integration: connects repositories
- REST API → Gitea integration: connects repositories
- REST API → Chat integrations: connects chat
- REST API → Webhooks: supports webhooks
- REST API → Project import: supports imports
- REST API → Object storage: stores attachments
