# georgijgrigoriev/litetask architecture

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

- Interactive diagram: https://gitdiagram.com/georgijgrigoriev/litetask
- Repository: https://github.com/georgijgrigoriev/litetask

## Overview

LiteTask is a self-hosted project task board. Users sign in, select a project, manage tasks and comments on status boards, while administrators manage accounts, roles, and project access. The React client calls the Go HTTP API, which provides session-authenticated application operations backed by SQLite. Optional Telegram and Discord bots expose bot-based task interactions. Backend wiring and API-to-store calls are supported by the documented architecture; UI-to-API calls are visible in the App excerpt. Bot wiring details are not shown, so those links are marked unverified.

Main entry points: [`web/src/App.tsx`](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/App.tsx) (App workflow), [`web/src/components/auth/AuthCard.tsx`](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/auth/AuthCard.tsx) (Sign-in and registration), [`internal/botcore/commander.go`](https://github.com/georgijgrigoriev/litetask/blob/main/internal/botcore/commander.go) (Shared bot commands), [`internal/store/store.go`](https://github.com/georgijgrigoriev/litetask/blob/main/internal/store/store.go) (Task and account store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App workflow<br/>[App.tsx]"]
  node_auth["Sign-in and registration<br/>[AuthCard.tsx]"]
  node_project_ui["Project management"]
  node_board["Task board<br/>[Board.tsx]"]
  node_task_detail["Task details and comments<br/>[TaskDetailCard.tsx]"]
  node_admin_ui["User and access management<br/>[UserTable.tsx]"]
  node_quick_add["Quick task entry<br/>[QuickAddPage.tsx]"]
  node_translations["Localization<br/>[index.tsx]"]
end

subgraph group_backend["Application backend"]
  node_http_api["HTTP API and sessions<br/>[server.go]"]
  node_botcore["Shared bot commands<br/>[commander.go]"]
end

subgraph group_persistence["Task data"]
  node_store[("Task and account store<br/>[store.go]")]
  node_sqlite[("SQLite database")]
end

subgraph group_integrations["Bot integrations"]
  node_telegram["Telegram bot<br/>[bot.go]"]
  node_discord["Discord bot<br/>[bot.go]"]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -->|"signs in"| node_auth
node_admin -->|"signs in"| node_auth
node_auth -->|"submits credentials"| node_app
node_user -->|"uses board"| node_app
node_admin -->|"manages users"| node_app
node_app -->|"renders"| node_project_ui
node_app -->|"renders"| node_board
node_app -->|"renders"| node_task_detail
node_app -->|"renders"| node_admin_ui
node_app -->|"renders"| node_quick_add
node_app -->|"uses translations"| node_translations
node_app -->|"sends API requests"| node_http_api
node_http_api -->|"reads and writes"| node_store
node_store -->|"persists data"| node_sqlite
node_telegram -.->|"delegates commands"| node_botcore
node_discord -.->|"delegates commands"| node_botcore
node_botcore -.->|"uses task data"| node_store

click node_app "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/App.tsx"
click node_auth "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/auth/AuthCard.tsx"
click node_project_ui "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/projects/ProjectManagerCard.tsx"
click node_board "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/tasks/Board.tsx"
click node_task_detail "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/tasks/TaskDetailCard.tsx"
click node_admin_ui "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/admin/UserTable.tsx"
click node_quick_add "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/quick/QuickAddPage.tsx"
click node_translations "https://github.com/georgijgrigoriev/litetask/blob/main/web/src/i18n/index.tsx"
click node_http_api "https://github.com/georgijgrigoriev/litetask/blob/main/internal/httpapi/server.go"
click node_botcore "https://github.com/georgijgrigoriev/litetask/blob/main/internal/botcore/commander.go"
click node_store "https://github.com/georgijgrigoriev/litetask/blob/main/internal/store/store.go"
click node_telegram "https://github.com/georgijgrigoriev/litetask/blob/main/internal/tgbot/bot.go"
click node_discord "https://github.com/georgijgrigoriev/litetask/blob/main/internal/discordbot/bot.go"

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_app,node_auth,node_project_ui,node_board,node_task_detail,node_admin_ui,node_quick_add,node_translations,node_user toneBlue
class node_http_api,node_botcore toneAmber
class node_store,node_sqlite toneMint
class node_telegram,node_discord toneRose
class node_admin toneIndigo
```

## Components

### Web client

- [App workflow](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Sign-in and registration](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/auth/AuthCard.tsx): `web/src/components/auth/AuthCard.tsx`
- [Project management](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/projects/ProjectManagerCard.tsx): `web/src/components/projects/ProjectManagerCard.tsx`
- [Task board](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/tasks/Board.tsx): `web/src/components/tasks/Board.tsx`
- [Task details and comments](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/tasks/TaskDetailCard.tsx): `web/src/components/tasks/TaskDetailCard.tsx`
- [User and access management](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/admin/UserTable.tsx): `web/src/components/admin/UserTable.tsx`
- [Quick task entry](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/components/quick/QuickAddPage.tsx): `web/src/components/quick/QuickAddPage.tsx`
- [Localization](https://github.com/georgijgrigoriev/litetask/blob/main/web/src/i18n/index.tsx): `web/src/i18n/index.tsx`

### Application backend

- [HTTP API and sessions](https://github.com/georgijgrigoriev/litetask/blob/main/internal/httpapi/server.go): `internal/httpapi/server.go`
- [Shared bot commands](https://github.com/georgijgrigoriev/litetask/blob/main/internal/botcore/commander.go): `internal/botcore/commander.go`

### Task data

- [Task and account store](https://github.com/georgijgrigoriev/litetask/blob/main/internal/store/store.go): `internal/store/store.go`
- **SQLite database**

### Bot integrations

- [Telegram bot](https://github.com/georgijgrigoriev/litetask/blob/main/internal/tgbot/bot.go): `internal/tgbot/bot.go`
- [Discord bot](https://github.com/georgijgrigoriev/litetask/blob/main/internal/discordbot/bot.go): `internal/discordbot/bot.go`

### Other components

- **User**
- **Administrator**

## Connections

- User → Sign-in and registration: signs in (evidence: `README.md`)
- Administrator → Sign-in and registration: signs in (evidence: `README.md`)
- Sign-in and registration → App workflow: submits credentials (evidence: `web/src/App.tsx`)
- User → App workflow: uses board (evidence: `README.md`)
- Administrator → App workflow: manages users (evidence: `README.md`)
- App workflow → Project management: renders (evidence: `web/src/App.tsx`)
- App workflow → Task board: renders (evidence: `web/src/App.tsx`)
- App workflow → Task details and comments: renders (evidence: `web/src/App.tsx`)
- App workflow → User and access management: renders (evidence: `web/src/App.tsx`)
- App workflow → Quick task entry: renders (evidence: `web/src/App.tsx`)
- App workflow → Localization: uses translations (evidence: `web/src/App.tsx`)
- App workflow → HTTP API and sessions: sends API requests (evidence: `web/src/App.tsx`)
- HTTP API and sessions → Task and account store: reads and writes (evidence: `README.md`)
- Task and account store → SQLite database: persists data (evidence: `README.md`)
- Telegram bot → Shared bot commands: delegates commands
- Discord bot → Shared bot commands: delegates commands
- Shared bot commands → Task and account store: uses task data
