# appsmithorg/appsmith architecture

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

- Interactive diagram: https://gitdiagram.com/appsmithorg/appsmith
- Repository: https://github.com/appsmithorg/appsmith

## Overview

Appsmith is an open-source low-code platform for creating custom business applications. The main user journey is to build an interface, connect it to data or services, configure and run operations, and use the resulting application. The tree and README also identify Git-based application workflows, import/export, and AI agents as product capabilities. Several backend and integration links are not demonstrated by the sampled excerpts, so those relationships are shown as unverified rather than asserted as observed calls.

Main entry points: [`app/client/src/entities/Engine/AppEditorEngine.ts`](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/entities/Engine/AppEditorEngine.ts) (IDE editor), [`app/server/appsmith-server/src/main/java/com/appsmith/server/controllers/ce/ApplicationControllerCE.java`](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/controllers/ce/ApplicationControllerCE.java) (Application API), [`app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java`](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java) (Datasource service), [`app/client/src/pages/AppIDE/components/QueryAdd/useQueryAdd.tsx`](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/pages/AppIDE/components/QueryAdd/useQueryAdd.tsx) (Query setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Application authoring"]
  node_editor["IDE editor<br/>[AppEditorEngine.ts]"]
  node_widgets["Widget library"]
  node_layout["Canvas layout"]
  node_queryadd["Query setup<br/>[useQueryAdd.tsx]"]
  node_queryops["Query operations"]
end

subgraph group_execution["Queries and execution"]
  node_run["Run action"]
end

subgraph group_platform["Server platform"]
  node_serverapi["Application API"]
  node_datasource["Datasource service"]
  node_datasourcemodel["Datasource model<br/>[Datasource.java]"]
  node_authmodel["Authentication config"]
  node_crud["Persistence services<br/>[BaseService.java]"]
end

subgraph group_integrations["Integrations and lifecycle"]
  node_git["Git workflows"]
  node_importexport["Import and export"]
  node_ai["AI agents<br/>[app.ts]"]
  node_plugin["Plugin services"]
end

node_user(("App builder"))

node_user -.->|"builds with"| node_editor
node_editor -.->|"composes UI"| node_widgets
node_editor -.->|"edits layout"| node_layout
node_editor -.->|"configures queries"| node_queryadd
node_queryadd -.->|"groups operations"| node_queryops
node_queryops -.->|"enables execution"| node_run
node_run -.->|"requests data"| node_serverapi
node_serverapi -.->|"uses datasource"| node_datasource
node_datasource -->|"handles config"| node_datasourcemodel
node_datasource -->|"handles auth"| node_authmodel
node_serverapi -.->|"persists entities"| node_crud
node_user -.->|"syncs applications"| node_git
node_user -.->|"moves applications"| node_importexport
node_user -.->|"uses agents"| node_ai
node_ai -.->|"connects models"| node_plugin

click node_editor "https://github.com/appsmithorg/appsmith/blob/release/app/client/src/entities/Engine/AppEditorEngine.ts"
click node_widgets "https://github.com/appsmithorg/appsmith/tree/release/app/client/packages/design-system/ads/src"
click node_layout "https://github.com/appsmithorg/appsmith/tree/release/app/client/src/layoutSystems"
click node_queryadd "https://github.com/appsmithorg/appsmith/blob/release/app/client/src/pages/AppIDE/components/QueryAdd/useQueryAdd.tsx"
click node_queryops "https://github.com/appsmithorg/appsmith/blob/release/app/client/src/ce/pages/AppIDE/components/QueryAdd/useGroupedAddQueryOperations.tsx"
click node_run "https://github.com/appsmithorg/appsmith/blob/release/app/client/src/ce/PluginActionEditor/hooks/useHandleRunClick.ts"
click node_serverapi "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/controllers/ce/ApplicationControllerCE.java"
click node_datasource "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java"
click node_datasourcemodel "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/Datasource.java"
click node_authmodel "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/AuthenticationDTO.java"
click node_crud "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/services/BaseService.java"
click node_git "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/git/controllers/GitApplicationControllerCE.java"
click node_importexport "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/imports/internal/artifactbased/ArtifactBasedImportService.java"
click node_ai "https://github.com/appsmithorg/appsmith/blob/release/app/client/packages/mcp/src/app.ts"
click node_plugin "https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-plugins/appsmithAiPlugin/src/main/java/com/external/plugins/services/AiServerService.java"

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_editor,node_widgets,node_layout,node_queryadd,node_queryops toneBlue
class node_run toneAmber
class node_serverapi,node_datasource,node_datasourcemodel,node_authmodel,node_crud toneMint
class node_git,node_importexport,node_ai,node_plugin toneRose
class node_user toneIndigo
```

## Components

### Application authoring

- [IDE editor](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/entities/Engine/AppEditorEngine.ts): `app/client/src/entities/Engine/AppEditorEngine.ts`
- [Widget library](https://github.com/appsmithorg/appsmith/tree/release/app/client/packages/design-system/ads/src): `app/client/packages/design-system/ads/src`
- [Canvas layout](https://github.com/appsmithorg/appsmith/tree/release/app/client/src/layoutSystems): `app/client/src/layoutSystems`
- [Query setup](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/pages/AppIDE/components/QueryAdd/useQueryAdd.tsx): `app/client/src/pages/AppIDE/components/QueryAdd/useQueryAdd.tsx`
- [Query operations](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/ce/pages/AppIDE/components/QueryAdd/useGroupedAddQueryOperations.tsx): `app/client/src/ce/pages/AppIDE/components/QueryAdd/useGroupedAddQueryOperations.tsx`

### Queries and execution

- [Run action](https://github.com/appsmithorg/appsmith/blob/release/app/client/src/ce/PluginActionEditor/hooks/useHandleRunClick.ts): `app/client/src/ce/PluginActionEditor/hooks/useHandleRunClick.ts`

### Server platform

- [Application API](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/controllers/ce/ApplicationControllerCE.java): `app/server/appsmith-server/src/main/java/com/appsmith/server/controllers/ce/ApplicationControllerCE.java`
- [Datasource service](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java): `app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java`
- [Datasource model](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/Datasource.java): `app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/Datasource.java`
- [Authentication config](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/AuthenticationDTO.java): `app/server/appsmith-interfaces/src/main/java/com/appsmith/external/models/AuthenticationDTO.java`
- [Persistence services](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/services/BaseService.java): `app/server/appsmith-server/src/main/java/com/appsmith/server/services/BaseService.java`

### Integrations and lifecycle

- [Git workflows](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/git/controllers/GitApplicationControllerCE.java): `app/server/appsmith-server/src/main/java/com/appsmith/server/git/controllers/GitApplicationControllerCE.java`
- [Import and export](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-server/src/main/java/com/appsmith/server/imports/internal/artifactbased/ArtifactBasedImportService.java): `app/server/appsmith-server/src/main/java/com/appsmith/server/imports/internal/artifactbased/ArtifactBasedImportService.java`
- [AI agents](https://github.com/appsmithorg/appsmith/blob/release/app/client/packages/mcp/src/app.ts): `app/client/packages/mcp/src/app.ts`
- [Plugin services](https://github.com/appsmithorg/appsmith/blob/release/app/server/appsmith-plugins/appsmithAiPlugin/src/main/java/com/external/plugins/services/AiServerService.java): `app/server/appsmith-plugins/appsmithAiPlugin/src/main/java/com/external/plugins/services/AiServerService.java`

### Other components

- **App builder**

## Connections

- App builder → IDE editor: builds with (evidence: `README.md`)
- IDE editor → Widget library: composes UI
- IDE editor → Canvas layout: edits layout
- IDE editor → Query setup: configures queries
- Query setup → Query operations: groups operations
- Query operations → Run action: enables execution
- Run action → Application API: requests data
- Application API → Datasource service: uses datasource
- Datasource service → Datasource model: handles config (evidence: `app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java`)
- Datasource service → Authentication config: handles auth (evidence: `app/server/appsmith-server/src/main/java/com/appsmith/server/datasourcestorages/base/DatasourceStorageServiceCEImpl.java`)
- Application API → Persistence services: persists entities
- App builder → Git workflows: syncs applications (evidence: `README.md`)
- App builder → Import and export: moves applications
- App builder → AI agents: uses agents (evidence: `README.md`)
- AI agents → Plugin services: connects models
