# makeplane/plane architecture

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

- Interactive diagram: https://gitdiagram.com/makeplane/plane
- Repository: https://github.com/makeplane/plane

## Overview

Plane is a project-management product for work items, cycles, modules, views, Pages, and analytics, with workspace and project administration. The main user workflow is to work in the web app, which calls API services; Django routes requests into domain views and persists product state in its models. The README documents the major capabilities, but their specific frontend-to-API wiring is not shown in the supplied excerpts, so those links are marked unverified rather than inferred. The graph also shows authentication and the evidenced asset metadata task. *Evidence limits: source excerpts are selective; dashed links represent documented capabilities or unverified boundaries.*

Main entry points: [`apps/api/plane/urls.py`](https://github.com/makeplane/plane/blob/preview/apps/api/plane/urls.py) (API routing), [`apps/api/plane/db/models/issue.py`](https://github.com/makeplane/plane/blob/preview/apps/api/plane/db/models/issue.py) (Domain models), [`packages/services/src/api.service.ts`](https://github.com/makeplane/plane/blob/preview/packages/services/src/api.service.ts) (HTTP service), [`apps/web/app/routes/core.ts`](https://github.com/makeplane/plane/blob/preview/apps/web/app/routes/core.ts) (Plane web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Product clients"]
  node_web["Plane web app<br/>[core.ts]"]
  node_space["Plane Space app<br/>[page.tsx]"]
  node_admin["Admin console<br/>[form.tsx]"]
end

subgraph group_features["Project work"]
  node_workitems["Work items<br/>[base.py]"]
  node_cycles["Cycles<br/>[base.py]"]
  node_modules["Modules<br/>[base.py]"]
  node_views["Saved views<br/>[base.py]"]
  node_pages["Pages<br/>[base.py]"]
  node_analytics["Analytics"]
  node_filters["Rich filters<br/>[filter.ts]"]
end

subgraph group_api["API and identity"]
  node_auth["Authentication<br/>[email.py]"]
  node_authservice["Auth service<br/>[auth.service.ts]"]
  node_api_service["HTTP service<br/>[api.service.ts]"]
  node_routing["API routing<br/>[urls.py]"]
  node_assets["Asset endpoints<br/>[base.py]"]
end

subgraph group_state["Persistence and files"]
  node_models[("Domain models<br/>[issue.py]")]
  node_storage["S3-compatible storage<br/>[storage.py]"]
  node_asset_task["Asset metadata task"]
end

node_user(("Team member"))
node_object_store[("S3 / MinIO")]

node_user -->|"uses"| node_web
node_web -.->|"calls API"| node_api_service
node_space -.->|"calls API"| node_api_service
node_admin -.->|"calls API"| node_api_service
node_api_service -.->|"sends requests"| node_routing
node_routing -.->|"routes to"| node_workitems
node_routing -.->|"routes to"| node_cycles
node_routing -.->|"routes to"| node_modules
node_routing -.->|"routes to"| node_views
node_routing -.->|"routes to"| node_pages
node_routing -.->|"routes to"| node_analytics
node_routing -.->|"routes to"| node_auth
node_workitems -.->|"persists"| node_models
node_cycles -.->|"persists"| node_models
node_modules -.->|"persists"| node_models
node_views -.->|"persists"| node_models
node_pages -.->|"persists"| node_models
node_analytics -.->|"reads"| node_models
node_web -.->|"configures filters"| node_filters
node_authservice -->|"extends"| node_api_service
node_authservice -.->|"requests auth"| node_auth
node_assets -.->|"uses storage"| node_storage
node_asset_task -->|"loads asset"| node_models
node_asset_task -->|"gets metadata"| node_storage
node_storage -.->|"generates URLs"| node_object_store

click node_web "https://github.com/makeplane/plane/blob/preview/apps/web/app/routes/core.ts"
click node_space "https://github.com/makeplane/plane/blob/preview/apps/space/app/%5BworkspaceSlug%5D/%5BprojectId%5D/page.tsx"
click node_admin "https://github.com/makeplane/plane/blob/preview/apps/admin/app/(all)/(dashboard)/general/form.tsx"
click node_workitems "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/issue/base.py"
click node_cycles "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/cycle/base.py"
click node_modules "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/module/base.py"
click node_views "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/view/base.py"
click node_pages "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/page/base.py"
click node_analytics "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/analytic/project_analytics.py"
click node_filters "https://github.com/makeplane/plane/blob/preview/packages/shared-state/src/store/rich-filters/filter.ts"
click node_auth "https://github.com/makeplane/plane/blob/preview/apps/api/plane/authentication/views/app/email.py"
click node_authservice "https://github.com/makeplane/plane/blob/preview/packages/services/src/auth/auth.service.ts"
click node_api_service "https://github.com/makeplane/plane/blob/preview/packages/services/src/api.service.ts"
click node_routing "https://github.com/makeplane/plane/blob/preview/apps/api/plane/urls.py"
click node_models "https://github.com/makeplane/plane/blob/preview/apps/api/plane/db/models/issue.py"
click node_assets "https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/asset/base.py"
click node_storage "https://github.com/makeplane/plane/blob/preview/apps/api/plane/settings/storage.py"
click node_asset_task "https://github.com/makeplane/plane/blob/preview/apps/api/plane/bgtasks/storage_metadata_task.py"

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_space,node_admin toneBlue
class node_workitems,node_cycles,node_modules,node_views,node_pages,node_analytics,node_filters,node_object_store toneAmber
class node_auth,node_authservice,node_api_service,node_routing,node_assets toneMint
class node_models,node_storage,node_asset_task toneRose
class node_user toneIndigo
```

## Components

### Product clients

- [Plane web app](https://github.com/makeplane/plane/blob/preview/apps/web/app/routes/core.ts): `apps/web/app/routes/core.ts`
- [Plane Space app](https://github.com/makeplane/plane/blob/preview/apps/space/app/%5BworkspaceSlug%5D/%5BprojectId%5D/page.tsx): `apps/space/app/[workspaceSlug]/[projectId]/page.tsx`
- [Admin console](https://github.com/makeplane/plane/blob/preview/apps/admin/app/(all)/(dashboard)/general/form.tsx): `apps/admin/app/(all)/(dashboard)/general/form.tsx`

### Project work

- [Work items](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/issue/base.py): `apps/api/plane/app/views/issue/base.py`
- [Cycles](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/cycle/base.py): `apps/api/plane/app/views/cycle/base.py`
- [Modules](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/module/base.py): `apps/api/plane/app/views/module/base.py`
- [Saved views](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/view/base.py): `apps/api/plane/app/views/view/base.py`
- [Pages](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/page/base.py): `apps/api/plane/app/views/page/base.py`
- [Analytics](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/analytic/project_analytics.py): `apps/api/plane/app/views/analytic/project_analytics.py`
- [Rich filters](https://github.com/makeplane/plane/blob/preview/packages/shared-state/src/store/rich-filters/filter.ts): `packages/shared-state/src/store/rich-filters/filter.ts`

### API and identity

- [Authentication](https://github.com/makeplane/plane/blob/preview/apps/api/plane/authentication/views/app/email.py): `apps/api/plane/authentication/views/app/email.py`
- [Auth service](https://github.com/makeplane/plane/blob/preview/packages/services/src/auth/auth.service.ts): `packages/services/src/auth/auth.service.ts`
- [HTTP service](https://github.com/makeplane/plane/blob/preview/packages/services/src/api.service.ts): `packages/services/src/api.service.ts`
- [API routing](https://github.com/makeplane/plane/blob/preview/apps/api/plane/urls.py): `apps/api/plane/urls.py`
- [Asset endpoints](https://github.com/makeplane/plane/blob/preview/apps/api/plane/app/views/asset/base.py): `apps/api/plane/app/views/asset/base.py`

### Persistence and files

- [Domain models](https://github.com/makeplane/plane/blob/preview/apps/api/plane/db/models/issue.py): `apps/api/plane/db/models/issue.py`
- [S3-compatible storage](https://github.com/makeplane/plane/blob/preview/apps/api/plane/settings/storage.py): `apps/api/plane/settings/storage.py`
- [Asset metadata task](https://github.com/makeplane/plane/blob/preview/apps/api/plane/bgtasks/storage_metadata_task.py): `apps/api/plane/bgtasks/storage_metadata_task.py`

### Other components

- **Team member**
- **S3 / MinIO**

## Connections

- Team member → Plane web app: uses (evidence: `README.md`)
- Plane web app → HTTP service: calls API
- Plane Space app → HTTP service: calls API
- Admin console → HTTP service: calls API
- HTTP service → API routing: sends requests
- API routing → Work items: routes to
- API routing → Cycles: routes to
- API routing → Modules: routes to
- API routing → Saved views: routes to
- API routing → Pages: routes to
- API routing → Analytics: routes to
- API routing → Authentication: routes to
- Work items → Domain models: persists
- Cycles → Domain models: persists
- Modules → Domain models: persists
- Saved views → Domain models: persists
- Pages → Domain models: persists
- Analytics → Domain models: reads
- Plane web app → Rich filters: configures filters
- Auth service → HTTP service: extends (evidence: `packages/services/src/auth/auth.service.ts`)
- Auth service → Authentication: requests auth
- Asset endpoints → S3-compatible storage: uses storage
- Asset metadata task → Domain models: loads asset (evidence: `apps/api/plane/bgtasks/storage_metadata_task.py`)
- Asset metadata task → S3-compatible storage: gets metadata (evidence: `apps/api/plane/bgtasks/storage_metadata_task.py`)
- S3-compatible storage → S3 / MinIO: generates URLs
