# dinbtechit/jetbrains-nestjs architecture

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

- Interactive diagram: https://gitdiagram.com/dinbtechit/jetbrains-nestjs
- Repository: https://github.com/dinbtechit/jetbrains-nestjs

## Overview

Jetbrains NestJS is an IntelliJ IDE plugin that exposes Nest CLI/Schematics generation from project context menus. The main workflow is selecting a Nest project location, choosing a generator and options in a dialog, storing that request, then invoking the installed @nestjs/cli. The repository also includes Nest project detection, custom Nest file icons, plugin settings, and startup notifications. Edges reflect shown calls or README claims; unsampled registrations and supporting subsystems are not wired speculatively.

Main entry points: [`src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt) (CLI actions), [`src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt) (Generator dialog), [`src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt`](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt) (Nest project detection and runner), [`src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt`](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt) (Nest file icons)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI generation"]
  node_cli_actions["CLI actions"]
  node_generator_dialog["Generator dialog"]
  node_cli_completions["CLI option completion"]
  node_type_renderer["Generator type renderer"]
  node_cli_state["Generator request state<br/>[CLIState.kt]"]
  node_generator_paths["Generator path utility"]
end

subgraph group_project["Nest project context"]
  node_nest_project["Nest project detection and runner<br/>[NestProject.kt]"]
  node_nest_cli["Nest CLI package"]
end

subgraph group_ide["IDE support"]
  node_file_icons["Nest file icons"]
  node_icons["Icon resources<br/>[NestIcons.kt]"]
  node_settings_ui["Plugin settings UI"]
  node_settings_store[("Persistent settings<br/>[SettingsStore.kt]")]
end

subgraph group_updates["Plugin updates"]
  node_startup["Startup notification"]
  node_notification_actions["Notification actions"]
end

node_developer(("IDE user"))
node_ide_user(("IDE notifications"))

node_developer -->|"opens generator"| node_cli_actions
node_cli_actions -->|"checks project context"| node_nest_project
node_cli_actions -->|"opens dialog"| node_generator_dialog
node_cli_actions -->|"reads request"| node_cli_state
node_cli_actions -->|"runs generator"| node_nest_project
node_generator_dialog -->|"provides completions"| node_cli_completions
node_generator_dialog -->|"renders types"| node_type_renderer
node_generator_dialog -->|"computes target path"| node_generator_paths
node_generator_dialog -->|"dispatches request"| node_cli_state
node_nest_project -->|"updates options"| node_cli_state
node_nest_project -->|"invokes generator"| node_nest_cli
node_file_icons -->|"uses icons"| node_icons
node_file_icons -->|"checks Nest project"| node_nest_project
node_file_icons -->|"reads preferences"| node_settings_store
node_settings_ui -->|"updates settings"| node_settings_store
node_startup -->|"checks version"| node_settings_store
node_startup -->|"adds actions"| node_notification_actions
node_startup -->|"shows notification"| node_ide_user

click node_cli_actions "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt"
click node_generator_dialog "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt"
click node_cli_completions "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/CLIOptionsCompletionProvider.kt"
click node_type_renderer "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateTypeComboRenderer.kt"
click node_cli_state "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/store/CLIState.kt"
click node_generator_paths "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/util/NestGeneratorFileUtil.kt"
click node_nest_project "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt"
click node_file_icons "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt"
click node_icons "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/NestIcons.kt"
click node_settings_ui "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/NestPluginConfigurable.kt"
click node_settings_store "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/SettingsStore.kt"
click node_startup "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt"
click node_notification_actions "https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/notification/StarGithubRepoAction.kt"

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_cli_actions,node_generator_dialog,node_cli_completions,node_type_renderer,node_cli_state,node_generator_paths,node_developer toneBlue
class node_nest_project,node_nest_cli toneAmber
class node_file_icons,node_icons,node_settings_ui,node_settings_store toneMint
class node_startup,node_notification_actions toneRose
class node_ide_user toneIndigo
```

## Components

### CLI generation

- [CLI actions](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`
- [Generator dialog](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`
- [CLI option completion](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/CLIOptionsCompletionProvider.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/CLIOptionsCompletionProvider.kt`
- [Generator type renderer](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateTypeComboRenderer.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateTypeComboRenderer.kt`
- [Generator request state](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/store/CLIState.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/store/CLIState.kt`
- [Generator path utility](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/util/NestGeneratorFileUtil.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/util/NestGeneratorFileUtil.kt`

### Nest project context

- [Nest project detection and runner](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt`
- **Nest CLI package**

### IDE support

- [Nest file icons](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt`
- [Icon resources](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/NestIcons.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/NestIcons.kt`
- [Plugin settings UI](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/NestPluginConfigurable.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/NestPluginConfigurable.kt`
- [Persistent settings](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/SettingsStore.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/SettingsStore.kt`

### Plugin updates

- [Startup notification](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt`
- [Notification actions](https://github.com/dinbtechit/jetbrains-nestjs/blob/main/src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/notification/StarGithubRepoAction.kt): `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/notification/StarGithubRepoAction.kt`

### Other components

- **IDE user**
- **IDE notifications**

## Connections

- IDE user → CLI actions: opens generator (evidence: `README.md`)
- CLI actions → Nest project detection and runner: checks project context (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`)
- CLI actions → Generator dialog: opens dialog (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`)
- CLI actions → Generator request state: reads request (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`)
- CLI actions → Nest project detection and runner: runs generator (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/NestControllerCLIAction.kt`)
- Generator dialog → CLI option completion: provides completions (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`)
- Generator dialog → Generator type renderer: renders types (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`)
- Generator dialog → Generator path utility: computes target path (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`)
- Generator dialog → Generator request state: dispatches request (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/actions/cli/GenerateCLIDialog.kt`)
- Nest project detection and runner → Generator request state: updates options (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt`)
- Nest project detection and runner → Nest CLI package: invokes generator (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/common/nestProject/NestProject.kt`)
- Nest file icons → Icon resources: uses icons (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt`)
- Nest file icons → Nest project detection and runner: checks Nest project (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt`)
- Nest file icons → Persistent settings: reads preferences (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/projectExplorer/NestConfigFileIconProvider.kt`)
- Plugin settings UI → Persistent settings: updates settings (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/settings/NestPluginConfigurable.kt`)
- Startup notification → Persistent settings: checks version (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt`)
- Startup notification → Notification actions: adds actions (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt`)
- Startup notification → IDE notifications: shows notification (evidence: `src/main/kotlin/com/github/dinbtechit/jetbrainsnestjs/startup/MyStartupNotifyActivity.kt`)
