# suacayipkisi/t-code architecture

> Architecture diagram of the GitHub repository suacayipkisi/t-code, 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/suacayipkisi/t-code
- Repository: https://github.com/suacayipkisi/t-code

## Overview

T-Code is a GTK4 IDE for Linux. Users open a project and files, edit in tabs, and use language servers for code intelligence; they can then build, run, test, debug, search, and work with source control. The graph preserves these distinct capabilities, plus plugins, project sessions, and window infrastructure. README statements support several product-level links; source excerpts support startup, editor, session, and language-server relationships. Other source files were not inspected, so uncertain internal connections are omitted.

Main entry points: [`src/application/application.c`](https://github.com/suacayipkisi/t-code/blob/main/src/application/application.c) (Application Startup), [`src/lsp/client/client.c`](https://github.com/suacayipkisi/t-code/blob/main/src/lsp/client/client.c) (LSP Client), [`src/editor/editor.h`](https://github.com/suacayipkisi/t-code/blob/main/src/editor/editor.h) (Editor and Tabs), [`src/plugins/plugins.c`](https://github.com/suacayipkisi/t-code/blob/main/src/plugins/plugins.c) (Plugin Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["App and Window"]
  node_app["Application Startup<br/>[application.c]"]
  node_session["Project Session<br/>[session.c]"]
  node_window["IDE Window<br/>[window.h]"]
  node_palette["Themes<br/>[palette.h]"]
end

subgraph group_editing["Editing and Preview"]
  node_editor["Editor and Tabs<br/>[editor.h]"]
  node_preview["Markdown Preview<br/>[preview.c]"]
  node_search["Project Search<br/>[search.c]"]
end

subgraph group_language["Language Services"]
  node_lspclient["LSP Client<br/>[client.c]"]
  node_lspserver["Server Lifecycle<br/>[server.c]"]
  node_lspfeatures["Language Features<br/>[completion.c]"]
  node_debugger["Debugger<br/>[debugger.c]"]
end

subgraph group_workflow["Project Workflows"]
  node_buildrun["Build and Run<br/>[run.c]"]
  node_tasks["Project Tasks<br/>[tasks.c]"]
  node_testing["Test Discovery<br/>[frameworks.c]"]
  node_sourcecontrol["Source Control<br/>[scm.c]"]
end

subgraph group_extensions["Plugins and Tools"]
  node_plugins["Plugin Runtime<br/>[plugins.c]"]
  node_pluginmanager["Plugin Manager<br/>[manager.c]"]
  node_processes["Process Monitor<br/>[processes.c]"]
end

node_user(("IDE User"))
node_externalservers["Language Servers"]

node_user -->|"opens project"| node_app
node_app -->|"builds window"| node_window
node_app -->|"opens files"| node_editor
node_app -->|"restores tabs"| node_session
node_session -->|"restores tabs"| node_editor
node_user -->|"edits code"| node_editor
node_editor -->|"requests features"| node_lspclient
node_lspclient -->|"manages lifecycle"| node_lspserver
node_lspserver -->|"starts and stops"| node_externalservers
node_lspclient -->|"serves editor features"| node_lspfeatures
node_user -->|"builds and runs"| node_buildrun
node_user -->|"runs tests"| node_testing
node_user -->|"debugs programs"| node_debugger
node_user -->|"manages changes"| node_sourcecontrol
node_user -->|"searches project"| node_search
node_user -->|"previews Markdown"| node_preview
node_user -->|"manages plugins"| node_pluginmanager
node_pluginmanager -->|"enables plugins"| node_plugins
node_plugins -.->|"provides servers"| node_lspclient
node_user -->|"runs tasks"| node_tasks
node_plugins -.->|"monitors processes"| node_processes
node_window -->|"uses themes"| node_palette

click node_app "https://github.com/suacayipkisi/t-code/blob/main/src/application/application.c"
click node_session "https://github.com/suacayipkisi/t-code/blob/main/src/project/session.c"
click node_window "https://github.com/suacayipkisi/t-code/blob/main/src/window/window.h"
click node_palette "https://github.com/suacayipkisi/t-code/blob/main/src/window/palette.h"
click node_editor "https://github.com/suacayipkisi/t-code/blob/main/src/editor/editor.h"
click node_preview "https://github.com/suacayipkisi/t-code/blob/main/src/editor/preview/preview.c"
click node_search "https://github.com/suacayipkisi/t-code/blob/main/src/search/search.c"
click node_lspclient "https://github.com/suacayipkisi/t-code/blob/main/src/lsp/client/client.c"
click node_lspserver "https://github.com/suacayipkisi/t-code/blob/main/src/lsp/client/server.c"
click node_lspfeatures "https://github.com/suacayipkisi/t-code/blob/main/src/lsp/inline/completion.c"
click node_debugger "https://github.com/suacayipkisi/t-code/blob/main/src/debug/debugger.c"
click node_buildrun "https://github.com/suacayipkisi/t-code/blob/main/src/project/run/run.c"
click node_tasks "https://github.com/suacayipkisi/t-code/blob/main/src/project/run/tasks.c"
click node_testing "https://github.com/suacayipkisi/t-code/blob/main/src/testing/frameworks.c"
click node_sourcecontrol "https://github.com/suacayipkisi/t-code/blob/main/src/git/scm/scm.c"
click node_plugins "https://github.com/suacayipkisi/t-code/blob/main/src/plugins/plugins.c"
click node_pluginmanager "https://github.com/suacayipkisi/t-code/blob/main/src/plugins/manager.c"
click node_processes "https://github.com/suacayipkisi/t-code/blob/main/src/application/processes.c"

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_session,node_window,node_palette,node_user toneBlue
class node_editor,node_preview,node_search toneAmber
class node_lspclient,node_lspserver,node_lspfeatures,node_debugger,node_externalservers toneMint
class node_buildrun,node_tasks,node_testing,node_sourcecontrol toneRose
class node_plugins,node_pluginmanager,node_processes toneIndigo
```

## Components

### App and Window

- [Application Startup](https://github.com/suacayipkisi/t-code/blob/main/src/application/application.c): `src/application/application.c`
- [Project Session](https://github.com/suacayipkisi/t-code/blob/main/src/project/session.c): `src/project/session.c`
- [IDE Window](https://github.com/suacayipkisi/t-code/blob/main/src/window/window.h): `src/window/window.h`
- [Themes](https://github.com/suacayipkisi/t-code/blob/main/src/window/palette.h): `src/window/palette.h`

### Editing and Preview

- [Editor and Tabs](https://github.com/suacayipkisi/t-code/blob/main/src/editor/editor.h): `src/editor/editor.h`
- [Markdown Preview](https://github.com/suacayipkisi/t-code/blob/main/src/editor/preview/preview.c): `src/editor/preview/preview.c`
- [Project Search](https://github.com/suacayipkisi/t-code/blob/main/src/search/search.c): `src/search/search.c`

### Language Services

- [LSP Client](https://github.com/suacayipkisi/t-code/blob/main/src/lsp/client/client.c): `src/lsp/client/client.c`
- [Server Lifecycle](https://github.com/suacayipkisi/t-code/blob/main/src/lsp/client/server.c): `src/lsp/client/server.c`
- [Language Features](https://github.com/suacayipkisi/t-code/blob/main/src/lsp/inline/completion.c): `src/lsp/inline/completion.c`
- [Debugger](https://github.com/suacayipkisi/t-code/blob/main/src/debug/debugger.c): `src/debug/debugger.c`

### Project Workflows

- [Build and Run](https://github.com/suacayipkisi/t-code/blob/main/src/project/run/run.c): `src/project/run/run.c`
- [Project Tasks](https://github.com/suacayipkisi/t-code/blob/main/src/project/run/tasks.c): `src/project/run/tasks.c`
- [Test Discovery](https://github.com/suacayipkisi/t-code/blob/main/src/testing/frameworks.c): `src/testing/frameworks.c`
- [Source Control](https://github.com/suacayipkisi/t-code/blob/main/src/git/scm/scm.c): `src/git/scm/scm.c`

### Plugins and Tools

- [Plugin Runtime](https://github.com/suacayipkisi/t-code/blob/main/src/plugins/plugins.c): `src/plugins/plugins.c`
- [Plugin Manager](https://github.com/suacayipkisi/t-code/blob/main/src/plugins/manager.c): `src/plugins/manager.c`
- [Process Monitor](https://github.com/suacayipkisi/t-code/blob/main/src/application/processes.c): `src/application/processes.c`

### Other components

- **IDE User**
- **Language Servers**

## Connections

- IDE User → Application Startup: opens project
- Application Startup → IDE Window: builds window (evidence: `src/application/application.c`)
- Application Startup → Editor and Tabs: opens files (evidence: `src/application/application.c`)
- Application Startup → Project Session: restores tabs (evidence: `src/application/application.c`)
- Project Session → Editor and Tabs: restores tabs (evidence: `src/project/session.c`)
- IDE User → Editor and Tabs: edits code
- Editor and Tabs → LSP Client: requests features
- LSP Client → Server Lifecycle: manages lifecycle (evidence: `src/lsp/client/client.c`)
- Server Lifecycle → Language Servers: starts and stops (evidence: `src/lsp/client/server.c`)
- LSP Client → Language Features: serves editor features
- IDE User → Build and Run: builds and runs
- IDE User → Test Discovery: runs tests
- IDE User → Debugger: debugs programs
- IDE User → Source Control: manages changes
- IDE User → Project Search: searches project
- IDE User → Markdown Preview: previews Markdown
- IDE User → Plugin Manager: manages plugins
- Plugin Manager → Plugin Runtime: enables plugins
- Plugin Runtime → LSP Client: provides servers
- IDE User → Project Tasks: runs tasks
- Plugin Runtime → Process Monitor: monitors processes
- IDE Window → Themes: uses themes
