# it-nilesh/injectlynx architecture

> Architecture diagram of the GitHub repository it-nilesh/injectlynx, 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/it-nilesh/injectlynx
- Repository: https://github.com/it-nilesh/injectlynx

## Overview

Injectlynx is a compile-time, convention-based dependency-injection toolkit for .NET. The principal workflow is: an application author declares service conventions in the C# DSL; the Roslyn incremental generator analyzes those conventions and service types, then emits Microsoft DI registrations and an optional report for application startup to invoke. Separate capabilities include configuration diagnostics and fixes, CLI inspection/reporting, and opt-in runtime plugin loading. The graph reflects documented behavior and indexed source references; several generator internals and plugin stages were only partially excerpted.

Main entry points: [`src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoader.cs) (Plugin loader), [`src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs) (Incremental generator), [`src/Injectlynx.Generator/GeneratedRegistration.cs`](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/GeneratedRegistration.cs) (Registration plans), [`src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs`](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs) (Configuration analyzer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Configuration"]
  node_dsl["Convention DSL"]
end

subgraph group_generation["Code generation"]
  node_generator["Incremental generator"]
  node_models["Generation models<br/>[Models]"]
  node_registrations["Registration plans"]
  node_registration_writer["Registration writer"]
  node_report_writer["Report writer"]
end

subgraph group_tooling["Diagnostics and tools"]
  node_analyzer["Configuration analyzer"]
  node_codefix["IDE code fixes"]
  node_cli["Injectlynx CLI<br/>[InjectlynxCli.cs]"]
end

subgraph group_plugins["Runtime plugins"]
  node_plugin_api["Plugin API"]
  node_plugin_options["Plugin load options"]
  node_plugin_loader["Plugin loader"]
  node_plugin_extension["DI extension"]
  node_plugin_result["Load result"]
end

node_developer(("Application developer"))
node_app["Consuming application"]
node_service_collection["Microsoft DI services"]
node_plugin_files["Plugin assemblies and manifests"]

node_developer -->|"configures"| node_dsl
node_dsl -->|"declares conventions"| node_generator
node_generator -->|"uses models"| node_models
node_generator -->|"builds plans"| node_registrations
node_generator -->|"writes registrations"| node_registration_writer
node_generator -->|"writes reports"| node_report_writer
node_registrations -->|"provides plans"| node_registration_writer
node_registrations -->|"provides plans"| node_report_writer
node_registration_writer -->|"emits DI source"| node_app
node_report_writer -->|"emits report source"| node_app
node_developer -->|"gets diagnostics"| node_analyzer
node_analyzer -->|"uses diagnostics"| node_models
node_analyzer -->|"offers fixes"| node_codefix
node_developer -->|"runs commands"| node_cli
node_cli -->|"loads plugins"| node_plugin_loader
node_plugin_extension -->|"delegates loading"| node_plugin_loader
node_plugin_extension -->|"configures options"| node_plugin_options
node_plugin_loader -->|"reads options"| node_plugin_options
node_plugin_loader -->|"loads implementations"| node_plugin_api
node_plugin_loader -->|"returns result"| node_plugin_result
node_plugin_loader -->|"discovers assemblies"| node_plugin_files
node_plugin_loader -->|"registers services"| node_service_collection
node_app -->|"invokes generated method"| node_service_collection

click node_dsl "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/ServiceConventionDsl.cs"
click node_generator "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs"
click node_models "https://github.com/it-nilesh/injectlynx/tree/devlop/src/Injectlynx.Core/Models"
click node_registrations "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/GeneratedRegistration.cs"
click node_registration_writer "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/RegistrationSourceWriter.cs"
click node_report_writer "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/RegistrationReportSourceWriter.cs"
click node_analyzer "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs"
click node_codefix "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.CodeFixes/InjectlynxCodeFixProvider.cs"
click node_cli "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Cli/InjectlynxCli.cs"
click node_plugin_api "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/IInjectlynxPlugin.cs"
click node_plugin_options "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoadOptions.cs"
click node_plugin_loader "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoader.cs"
click node_plugin_extension "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginServiceCollectionExtensions.cs"
click node_plugin_result "https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoadResult.cs"

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_dsl toneBlue
class node_generator,node_models,node_registrations,node_registration_writer,node_report_writer toneAmber
class node_analyzer,node_codefix,node_cli toneMint
class node_plugin_api,node_plugin_options,node_plugin_loader,node_plugin_extension,node_plugin_result toneRose
class node_developer,node_app,node_service_collection,node_plugin_files toneIndigo
```

## Components

### Configuration

- [Convention DSL](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/ServiceConventionDsl.cs): `src/Injectlynx/ServiceConventionDsl.cs`

### Code generation

- [Incremental generator](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs): `src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`
- [Generation models](https://github.com/it-nilesh/injectlynx/tree/devlop/src/Injectlynx.Core/Models): `src/Injectlynx.Core/Models`
- [Registration plans](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/GeneratedRegistration.cs): `src/Injectlynx.Generator/GeneratedRegistration.cs`
- [Registration writer](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/RegistrationSourceWriter.cs): `src/Injectlynx.Generator/RegistrationSourceWriter.cs`
- [Report writer](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Generator/RegistrationReportSourceWriter.cs): `src/Injectlynx.Generator/RegistrationReportSourceWriter.cs`

### Diagnostics and tools

- [Configuration analyzer](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs): `src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs`
- [IDE code fixes](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.CodeFixes/InjectlynxCodeFixProvider.cs): `src/Injectlynx.CodeFixes/InjectlynxCodeFixProvider.cs`
- [Injectlynx CLI](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx.Cli/InjectlynxCli.cs): `src/Injectlynx.Cli/InjectlynxCli.cs`

### Runtime plugins

- [Plugin API](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/IInjectlynxPlugin.cs): `src/Injectlynx/Plugins/IInjectlynxPlugin.cs`
- [Plugin load options](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoadOptions.cs): `src/Injectlynx/Plugins/InjectlynxPluginLoadOptions.cs`
- [Plugin loader](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoader.cs): `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`
- [DI extension](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginServiceCollectionExtensions.cs): `src/Injectlynx/Plugins/InjectlynxPluginServiceCollectionExtensions.cs`
- [Load result](https://github.com/it-nilesh/injectlynx/blob/devlop/src/Injectlynx/Plugins/InjectlynxPluginLoadResult.cs): `src/Injectlynx/Plugins/InjectlynxPluginLoadResult.cs`

### Other components

- **Application developer**
- **Consuming application**
- **Microsoft DI services**
- **Plugin assemblies and manifests**

## Connections

- Application developer → Convention DSL: configures (evidence: `README.md`)
- Convention DSL → Incremental generator: declares conventions (evidence: `README.md`)
- Incremental generator → Generation models: uses models (evidence: `src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`)
- Incremental generator → Registration plans: builds plans (evidence: `src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`)
- Incremental generator → Registration writer: writes registrations (evidence: `src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`)
- Incremental generator → Report writer: writes reports (evidence: `src/Injectlynx.Generator/InjectlynxIncrementalGenerator.cs`)
- Registration plans → Registration writer: provides plans (evidence: `src/Injectlynx.Generator/RegistrationSourceWriter.cs`)
- Registration plans → Report writer: provides plans (evidence: `src/Injectlynx.Generator/RegistrationReportSourceWriter.cs`)
- Registration writer → Consuming application: emits DI source (evidence: `README.md`)
- Report writer → Consuming application: emits report source (evidence: `README.md`)
- Application developer → Configuration analyzer: gets diagnostics (evidence: `src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs`)
- Configuration analyzer → Generation models: uses diagnostics (evidence: `src/Injectlynx.Analyzers/InjectlynxConfigurationAnalyzer.cs`)
- Configuration analyzer → IDE code fixes: offers fixes (evidence: `src/Injectlynx.CodeFixes/InjectlynxCodeFixProvider.cs`)
- Application developer → Injectlynx CLI: runs commands (evidence: `src/Injectlynx.Cli/InjectlynxCli.cs`)
- Injectlynx CLI → Plugin loader: loads plugins (evidence: `src/Injectlynx.Cli/InjectlynxCli.cs`)
- DI extension → Plugin loader: delegates loading (evidence: `src/Injectlynx/Plugins/InjectlynxPluginServiceCollectionExtensions.cs`)
- DI extension → Plugin load options: configures options (evidence: `src/Injectlynx/Plugins/InjectlynxPluginServiceCollectionExtensions.cs`)
- Plugin loader → Plugin load options: reads options (evidence: `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`)
- Plugin loader → Plugin API: loads implementations (evidence: `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`)
- Plugin loader → Load result: returns result (evidence: `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`)
- Plugin loader → Plugin assemblies and manifests: discovers assemblies (evidence: `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`)
- Plugin loader → Microsoft DI services: registers services (evidence: `src/Injectlynx/Plugins/InjectlynxPluginLoader.cs`)
- Consuming application → Microsoft DI services: invokes generated method (evidence: `README.md`)
