# fisal101/kanban-board architecture

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

- Interactive diagram: https://gitdiagram.com/fisal101/kanban-board
- Repository: https://github.com/fisal101/kanban-board

## Overview

Kanban Board is a React frontend backed by an Express REST API and JSON-file persistence. A user views the board, creates or edits cards, deletes them, and drags them between columns; the frontend sends those operations to the API, which delegates board changes to storage. The UI also supports priority filtering and board-summary stats. Source excerpts show the frontend entry point, API calls, server routes, and storage implementation; the documented API establishes the frontend/backend boundary.

Main entry points: [`frontend/src/App.jsx`](https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx) (Board UI), [`frontend/src/main.jsx`](https://github.com/fisal101/kanban-board/blob/main/frontend/src/main.jsx) (React entry), [`frontend/src/api.js`](https://github.com/fisal101/kanban-board/blob/main/frontend/src/api.js) (API client), [`backend/src/server.js`](https://github.com/fisal101/kanban-board/blob/main/backend/src/server.js) (HTTP routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Board interface"]
  node_entry["React entry<br/>[main.jsx]"]
  node_board["Board UI<br/>[App.jsx]"]
  node_cardwork["Card workflows<br/>[App.jsx]"]
  node_boardviews["Board views<br/>[App.jsx]"]
  node_clientapi["API client<br/>[api.js]"]
end

subgraph group_backend["REST backend"]
  node_routes["HTTP routes<br/>[server.js]"]
end

subgraph group_persistence["Board persistence"]
  node_boardlogic["Board operations<br/>[store.js]"]
  node_boardfile[("Board JSON<br/>[boards.json]")]
end

node_user(("Board user"))

node_user -->|"uses"| node_entry
node_entry -->|"renders"| node_board
node_board -->|"handles"| node_cardwork
node_board -->|"renders"| node_boardviews
node_board -->|"requests"| node_clientapi
node_clientapi -->|"calls API"| node_routes
node_routes -->|"delegates"| node_boardlogic
node_boardlogic -->|"reads and writes"| node_boardfile

click node_entry "https://github.com/fisal101/kanban-board/blob/main/frontend/src/main.jsx"
click node_board "https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx"
click node_cardwork "https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx"
click node_boardviews "https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx"
click node_clientapi "https://github.com/fisal101/kanban-board/blob/main/frontend/src/api.js"
click node_routes "https://github.com/fisal101/kanban-board/blob/main/backend/src/server.js"
click node_boardlogic "https://github.com/fisal101/kanban-board/blob/main/backend/src/store.js"
click node_boardfile "https://github.com/fisal101/kanban-board/blob/main/backend/data/boards.json"

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_entry,node_board,node_cardwork,node_boardviews,node_clientapi,node_user toneBlue
class node_routes toneAmber
class node_boardlogic,node_boardfile toneMint
```

## Components

### Board interface

- [React entry](https://github.com/fisal101/kanban-board/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Board UI](https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Card workflows](https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Board views](https://github.com/fisal101/kanban-board/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/fisal101/kanban-board/blob/main/frontend/src/api.js): `frontend/src/api.js`

### REST backend

- [HTTP routes](https://github.com/fisal101/kanban-board/blob/main/backend/src/server.js): `backend/src/server.js`

### Board persistence

- [Board operations](https://github.com/fisal101/kanban-board/blob/main/backend/src/store.js): `backend/src/store.js`
- [Board JSON](https://github.com/fisal101/kanban-board/blob/main/backend/data/boards.json): `backend/data/boards.json`

### Other components

- **Board user**

## Connections

- Board user → React entry: uses
- React entry → Board UI: renders (evidence: `frontend/src/main.jsx`)
- Board UI → Card workflows: handles (evidence: `frontend/src/App.jsx`)
- Board UI → Board views: renders (evidence: `frontend/src/App.jsx`)
- Board UI → API client: requests (evidence: `frontend/src/App.jsx`)
- API client → HTTP routes: calls API (evidence: `README.md`)
- HTTP routes → Board operations: delegates (evidence: `backend/src/server.js`)
- Board operations → Board JSON: reads and writes (evidence: `backend/src/store.js`)
