# n3oltd/umbraco-extensions architecture

> Architecture diagram of the GitHub repository n3oltd/umbraco-extensions, 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/n3oltd/umbraco-extensions
- Repository: https://github.com/n3oltd/umbraco-extensions

## Overview

N3O Umbraco Extensions is a collection of NuGet extensions that add generic CMS capabilities and N3O Cloud integrations to Umbraco. The principal request workflow is an Umbraco API call handled by a feature controller, which may dispatch application requests through the mediator; specialized paths include giving lookup/pricing, block preview, and file upload/download. Other packages cover accounts, analytics, authentication, data exchange, marketing, newsletters, payments, and integrations. The graph reflects README-documented capabilities and the sampled/indexed source; unsampled subsystem internals and their connections are not inferred.

Main entry points: [`src/Mediator/N3O.Umbraco.Mediator/Mediator/Mediator.cs`](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Mediator/N3O.Umbraco.Mediator/Mediator/Mediator.cs) (Request mediator), [`src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs`](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs) (Block preview), [`src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs`](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs) (Storage API), [`src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs`](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs) (Giving API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cms["CMS foundations"]
  node_api["API controller base<br/>[ApiController.cs]"]
  node_mediator["Request mediator<br/>[Mediator.cs]"]
  node_validation["Request validation"]
  node_lookups["Lookup service<br/>[Lookups.cs]"]
  node_value_types["Value types<br/>[Value.cs]"]
end

subgraph group_giving["Giving and accounts"]
  node_name_model["Account name model<br/>[Name.cs]"]
  node_giving_api["Giving API"]
  node_cart["Giving cart<br/>[CartController.cs]"]
  node_checkout["Giving checkout"]
  node_accounts_api["Accounts API"]
  node_payments["Payment integrations"]
  node_crowdfunding["Crowdfunding"]
end

subgraph group_content["Content features"]
  node_blocks_preview["Block preview"]
  node_analytics["Analytics modules"]
  node_cropper["Image cropper"]
end

subgraph group_integrations["Service integrations"]
  node_storage_api["Storage API"]
  node_azure_storage["Azure storage setup"]
  node_auth0["Auth0 integration"]
  node_cloud_preview["Cloud preview"]
end

subgraph group_exchange["Data exchange"]
  node_data_imports["Data imports"]
  node_marketing_export["Marketing export"]
  node_newsletters["Newsletters"]
end

node_site_user(("Site user"))

node_site_user -->|"calls API"| node_giving_api
node_giving_api -->|"dispatches requests"| node_mediator
node_site_user -->|"uploads or downloads"| node_storage_api
node_storage_api -.->|"uses configured volume"| node_azure_storage
node_site_user -->|"requests preview"| node_blocks_preview
node_blocks_preview -.->|"preview dispatch"| node_mediator
node_blocks_preview -.->|"uses content model"| node_name_model
node_marketing_export -.->|"dispatches requests"| node_mediator
node_cloud_preview -->|"dispatches query"| node_mediator
node_azure_storage -->|"registers volume"| node_storage_api

click node_api "https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Hosting/Controllers/ApiController.cs"
click node_mediator "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Mediator/N3O.Umbraco.Mediator/Mediator/Mediator.cs"
click node_validation "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Validation/N3O.Umbraco.Validation/Hosting/ValidatorPipelineBehaviour.cs"
click node_lookups "https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Lookups/Lookups.cs"
click node_value_types "https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Types/Value.cs"
click node_name_model "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Accounts/N3O.Umbraco.Accounts/Models/Name/Name.cs"
click node_giving_api "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs"
click node_cart "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving.Cart/Controllers/CartController.cs"
click node_checkout "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving.Checkout/Controllers/CheckoutStagePageController.cs"
click node_accounts_api "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Accounts/N3O.Umbraco.Accounts/Controllers/AccountsController.cs"
click node_payments "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Payments/N3O.Umbraco.Payments.Stripe/Controllers/StripeController.cs"
click node_blocks_preview "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs"
click node_analytics "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Analytics/N3O.Umbraco.Analytics/Modules/GoogleTagManagerPageModule.cs"
click node_cropper "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Plugins/Cropper/N3O.Umbraco.Cropper/Controllers/CropperController.cs"
click node_storage_api "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs"
click node_azure_storage "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Storage/N3O.Umbraco.Storage.Azure/AzureStorageComposer.cs"
click node_auth0 "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Authentication/N3O.Umbraco.Authentication.Auth0/Services/Auth0ClientFactory.cs"
click node_cloud_preview "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Cloud/N3O.Umbraco.Cloud.Platforms/Handlers/GetPreviewHtmlHandler.cs"
click node_data_imports "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Data/N3O.Umbraco.Data/Controllers/ImportsController.cs"
click node_marketing_export "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Marketing/N3O.Umbraco.Marketing/Controllers/MarketingExportController.cs"
click node_newsletters "https://github.com/n3oltd/umbraco-extensions/blob/main/src/Newsletters/N3O.Umbraco.Newsletters/Controllers/NewslettersController.cs"
click node_crowdfunding "https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Clients/Crowdfunding/CrowdfundingClient.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_api,node_mediator,node_validation,node_lookups,node_value_types,node_site_user toneBlue
class node_name_model,node_giving_api,node_cart,node_checkout,node_accounts_api,node_payments,node_crowdfunding toneAmber
class node_blocks_preview,node_analytics,node_cropper toneMint
class node_storage_api,node_azure_storage,node_auth0,node_cloud_preview toneRose
class node_data_imports,node_marketing_export,node_newsletters toneIndigo
```

## Components

### CMS foundations

- [API controller base](https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Hosting/Controllers/ApiController.cs): `src/N3O.Umbraco.Extensions/Hosting/Controllers/ApiController.cs`
- [Request mediator](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Mediator/N3O.Umbraco.Mediator/Mediator/Mediator.cs): `src/Mediator/N3O.Umbraco.Mediator/Mediator/Mediator.cs`
- [Request validation](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Validation/N3O.Umbraco.Validation/Hosting/ValidatorPipelineBehaviour.cs): `src/Validation/N3O.Umbraco.Validation/Hosting/ValidatorPipelineBehaviour.cs`
- [Lookup service](https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Lookups/Lookups.cs): `src/N3O.Umbraco.Extensions/Lookups/Lookups.cs`
- [Value types](https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Extensions/Types/Value.cs): `src/N3O.Umbraco.Extensions/Types/Value.cs`

### Giving and accounts

- [Account name model](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Accounts/N3O.Umbraco.Accounts/Models/Name/Name.cs): `src/Accounts/N3O.Umbraco.Accounts/Models/Name/Name.cs`
- [Giving API](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs): `src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs`
- [Giving cart](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving.Cart/Controllers/CartController.cs): `src/Giving/N3O.Umbraco.Giving.Cart/Controllers/CartController.cs`
- [Giving checkout](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Giving/N3O.Umbraco.Giving.Checkout/Controllers/CheckoutStagePageController.cs): `src/Giving/N3O.Umbraco.Giving.Checkout/Controllers/CheckoutStagePageController.cs`
- [Accounts API](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Accounts/N3O.Umbraco.Accounts/Controllers/AccountsController.cs): `src/Accounts/N3O.Umbraco.Accounts/Controllers/AccountsController.cs`
- [Payment integrations](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Payments/N3O.Umbraco.Payments.Stripe/Controllers/StripeController.cs): `src/Payments/N3O.Umbraco.Payments.Stripe/Controllers/StripeController.cs`
- [Crowdfunding](https://github.com/n3oltd/umbraco-extensions/blob/main/src/N3O.Umbraco.Clients/Crowdfunding/CrowdfundingClient.cs): `src/N3O.Umbraco.Clients/Crowdfunding/CrowdfundingClient.cs`

### Content features

- [Block preview](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs): `src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs`
- [Analytics modules](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Analytics/N3O.Umbraco.Analytics/Modules/GoogleTagManagerPageModule.cs): `src/Analytics/N3O.Umbraco.Analytics/Modules/GoogleTagManagerPageModule.cs`
- [Image cropper](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Plugins/Cropper/N3O.Umbraco.Cropper/Controllers/CropperController.cs): `src/Plugins/Cropper/N3O.Umbraco.Cropper/Controllers/CropperController.cs`

### Service integrations

- [Storage API](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs): `src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs`
- [Azure storage setup](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Storage/N3O.Umbraco.Storage.Azure/AzureStorageComposer.cs): `src/Storage/N3O.Umbraco.Storage.Azure/AzureStorageComposer.cs`
- [Auth0 integration](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Authentication/N3O.Umbraco.Authentication.Auth0/Services/Auth0ClientFactory.cs): `src/Authentication/N3O.Umbraco.Authentication.Auth0/Services/Auth0ClientFactory.cs`
- [Cloud preview](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Cloud/N3O.Umbraco.Cloud.Platforms/Handlers/GetPreviewHtmlHandler.cs): `src/Cloud/N3O.Umbraco.Cloud.Platforms/Handlers/GetPreviewHtmlHandler.cs`

### Data exchange

- [Data imports](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Data/N3O.Umbraco.Data/Controllers/ImportsController.cs): `src/Data/N3O.Umbraco.Data/Controllers/ImportsController.cs`
- [Marketing export](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Marketing/N3O.Umbraco.Marketing/Controllers/MarketingExportController.cs): `src/Marketing/N3O.Umbraco.Marketing/Controllers/MarketingExportController.cs`
- [Newsletters](https://github.com/n3oltd/umbraco-extensions/blob/main/src/Newsletters/N3O.Umbraco.Newsletters/Controllers/NewslettersController.cs): `src/Newsletters/N3O.Umbraco.Newsletters/Controllers/NewslettersController.cs`

### Other components

- **Site user**

## Connections

- Site user → Giving API: calls API (evidence: `src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs`)
- Giving API → Request mediator: dispatches requests (evidence: `src/Giving/N3O.Umbraco.Giving/Controllers/GivingController.cs`)
- Site user → Storage API: uploads or downloads (evidence: `src/Storage/N3O.Umbraco.Storage/Controllers/StorageController.cs`)
- Storage API → Azure storage setup: uses configured volume
- Site user → Block preview: requests preview (evidence: `src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs`)
- Block preview → Request mediator: preview dispatch
- Block preview → Account name model: uses content model (evidence: `src/Blocks/N3O.Umbraco.Blocks/Controllers/BlockPreviewBackofficeController.cs`)
- Marketing export → Request mediator: dispatches requests
- Cloud preview → Request mediator: dispatches query (evidence: `src/Cloud/N3O.Umbraco.Cloud.Platforms/Handlers/GetPreviewHtmlHandler.cs`)
- Azure storage setup → Storage API: registers volume (evidence: `src/Storage/N3O.Umbraco.Storage.Azure/AzureStorageComposer.cs`)
