# fadhlimaulidri/plane architecture

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

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

## Overview

Plane is an open-source project-management product. A user manages work items, organizes them into cycles and modules, filters them through saved views, and reviews project analytics; Pages support documentation and AI-assisted note work. The repository includes React Router applications, a Django API, shared services and state, and persistent domain models. The README establishes the product capabilities, while sampled code confirms selected internal links; unsampled feature internals and most frontend-to-API wiring are therefore left unconnected rather than inferred.

Main entry points: [`apps/web/app/routes/core.ts`](https://github.com/fadhlimaulidri/plane/blob/preview/apps/web/app/routes/core.ts) (Plane web app), [`apps/api/plane/urls.py`](https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/urls.py) (Django API), [`packages/services/src/api.service.ts`](https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/api.service.ts) (HTTP services), [`packages/services/src/auth/auth.service.ts`](https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/auth/auth.service.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_web["Plane web app<br/>[core.ts]"]
  node_space["Plane Space app<br/>[page.tsx]"]
  node_admin["Instance admin"]
end

subgraph group_backend["API and domain"]
  node_workitems["Work items"]
  node_cycles["Cycles"]
  node_modules["Modules"]
  node_views["Saved views<br/>[base.py]"]
  node_pages["Pages"]
  node_analytics["Analytics"]
  node_api["Django API<br/>[urls.py]"]
  node_models[("Domain models")]
  node_auth["Authentication"]
  node_asset["File storage<br/>[storage.py]"]
end

subgraph group_shared["Shared runtime"]
  node_services["HTTP services<br/>[api.service.ts]"]
  node_authservice["Auth service<br/>[auth.service.ts]"]
  node_filter["Rich filters<br/>[filter.ts]"]
  node_filterconfig["Filter config<br/>[config-manager.ts]"]
end

node_user(("Team member"))

node_user -->|"uses"| node_web
node_user -->|"uses"| node_space
node_user -->|"configures"| node_admin
node_web -.->|"manages"| node_workitems
node_web -.->|"tracks"| node_cycles
node_web -.->|"organizes"| node_modules
node_web -.->|"filters"| node_views
node_web -.->|"documents"| node_pages
node_web -.->|"reviews"| node_analytics
node_services -->|"provides requests"| node_authservice
node_filter -->|"manages configs"| node_filterconfig
node_authservice -->|"inherits"| node_services
node_api -.->|"routes auth"| node_auth
node_api -.->|"persists domain data"| node_models
node_api -.->|"handles assets"| node_asset

click node_web "https://github.com/fadhlimaulidri/plane/blob/preview/apps/web/app/routes/core.ts"
click node_space "https://github.com/fadhlimaulidri/plane/blob/preview/apps/space/app/%5BworkspaceSlug%5D/%5BprojectId%5D/page.tsx"
click node_admin "https://github.com/fadhlimaulidri/plane/tree/preview/apps/admin/app/(all)/(dashboard)"
click node_workitems "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/issue"
click node_cycles "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/cycle"
click node_modules "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/module"
click node_views "https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/app/views/view/base.py"
click node_pages "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/page"
click node_analytics "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/analytic"
click node_api "https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/urls.py"
click node_models "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/db/models"
click node_auth "https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/authentication"
click node_asset "https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/settings/storage.py"
click node_services "https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/api.service.ts"
click node_authservice "https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/auth/auth.service.ts"
click node_filter "https://github.com/fadhlimaulidri/plane/blob/preview/packages/shared-state/src/store/rich-filters/filter.ts"
click node_filterconfig "https://github.com/fadhlimaulidri/plane/blob/preview/packages/shared-state/src/store/rich-filters/config-manager.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_space,node_admin toneBlue
class node_workitems,node_cycles,node_modules,node_views,node_pages,node_analytics,node_api,node_models,node_auth,node_asset toneAmber
class node_services,node_authservice,node_filter,node_filterconfig toneMint
class node_user toneIndigo
```

## Components

### User applications

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

### API and domain

- [Work items](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/issue): `apps/api/plane/app/views/issue`
- [Cycles](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/cycle): `apps/api/plane/app/views/cycle`
- [Modules](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/module): `apps/api/plane/app/views/module`
- [Saved views](https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/app/views/view/base.py): `apps/api/plane/app/views/view/base.py`
- [Pages](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/page): `apps/api/plane/app/views/page`
- [Analytics](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/app/views/analytic): `apps/api/plane/app/views/analytic`
- [Django API](https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/urls.py): `apps/api/plane/urls.py`
- [Domain models](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/db/models): `apps/api/plane/db/models`
- [Authentication](https://github.com/fadhlimaulidri/plane/tree/preview/apps/api/plane/authentication): `apps/api/plane/authentication`
- [File storage](https://github.com/fadhlimaulidri/plane/blob/preview/apps/api/plane/settings/storage.py): `apps/api/plane/settings/storage.py`

### Shared runtime

- [HTTP services](https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/api.service.ts): `packages/services/src/api.service.ts`
- [Auth service](https://github.com/fadhlimaulidri/plane/blob/preview/packages/services/src/auth/auth.service.ts): `packages/services/src/auth/auth.service.ts`
- [Rich filters](https://github.com/fadhlimaulidri/plane/blob/preview/packages/shared-state/src/store/rich-filters/filter.ts): `packages/shared-state/src/store/rich-filters/filter.ts`
- [Filter config](https://github.com/fadhlimaulidri/plane/blob/preview/packages/shared-state/src/store/rich-filters/config-manager.ts): `packages/shared-state/src/store/rich-filters/config-manager.ts`

### Other components

- **Team member**

## Connections

- Team member → Plane web app: uses (evidence: `README.md`)
- Team member → Plane Space app: uses (evidence: `README.md`)
- Team member → Instance admin: configures (evidence: `README.md`)
- Plane web app → Work items: manages
- Plane web app → Cycles: tracks
- Plane web app → Modules: organizes
- Plane web app → Saved views: filters
- Plane web app → Pages: documents
- Plane web app → Analytics: reviews
- HTTP services → Auth service: provides requests (evidence: `packages/services/src/auth/auth.service.ts`)
- Rich filters → Filter config: manages configs (evidence: `packages/shared-state/src/store/rich-filters/filter.ts`)
- Auth service → HTTP services: inherits (evidence: `packages/services/src/auth/auth.service.ts`)
- Django API → Authentication: routes auth
- Django API → Domain models: persists domain data
- Django API → File storage: handles assets