Umbraco Turbo Pro

Project Structure

uTPro follows a clean modular architecture with clear separation of concerns.

Prerequisites

• .NET 10 SDK (10.0.301 or later — pinned in global.json)
• A database engine — PostgreSQL (default), SQL Server, or SQLite
• Visual Studio 2022 (v17.12+) or VS Code with C# Dev Kit
• Node.js (optional, for frontend tooling)

Solution Architecture

uTPro/
├── Common/
│   └── uTPro.Common/              # Shared models, constants, CMS content types
├── Extension/
│   ├── uTPro.Extension/           # Reusable helpers (HTML sections, script queue, content traversal)
│   └── uTPro.Extension.CurrentSite/ # Per-request site context (culture, domains, navigation)
├── Foundation/
│   ├── uTPro.Foundation/          # Media path scheme
│   ├── uTPro.Foundation.Favicon/  # Dynamic favicon from CMS
│   ├── uTPro.Foundation.Middleware/ # Request localization, buffering
│   ├── uTPro.Foundation.Robots/   # robots.txt generation
│   └── uTPro.Foundation.Sitemap/  # sitemap.xml generation (cached)
├── Feature/
│   ├── uTPro.Feature/             # Feature base (shared partials)
│   └── uTPro.Feature.Dashboard/   # Backoffice dashboard + header app
├── Project/
│   ├── uTPro.Project.Web/         # Main web application
│   └── uTPro.Project.Web.Configure/ # Render controller, error handling, policies
├── global.json
└── uTPro.sln

Optional feature packages ship as standalone NuGet packages in their own repositories: File Manager, Simple Form Builder, Audit Log, Job Monitor, Auto Translation, and URL Viewer.

Web Project Structure (uTPro.Project.Web)

uTPro.Project.Web/
├── Controllers/Pages/         # Sitemap, Robots, Favicon controllers
├── Models/                    # View models
├── Startup/                   # Application startup (modular configuration)
│   ├── HostingSetup.cs        #   TMP/TEMP override for multi-site IIS
│   ├── UmbracoSetup.cs        #   Umbraco CMS builder + BlockPreview
│   ├── PerformanceSetup.cs    #   Razor, WebOptimizer, WebMarkupMin, OutputCache
│   ├── SecuritySetup.cs       #   DataProtection, Form/IIS/Kestrel limits
│   ├── BlockPreviewSetup.cs   #   Custom view locations + preview service
│   └── PipelineSetup.cs       #   Middleware pipeline
├── Views/
│   ├── Partials/common/       # MetaData.cshtml (SEO), HtmlManage.cshtml
│   ├── Partials/blockgrid/    # Block grid rendering templates
│   ├── uTPro/                 # Site-specific views (Layout, Nav, Pages, Components)
│   ├── globalLayout.cshtml    # Fallback layout
│   └── globalPageError.cshtml # Error page template
├── wwwroot/
│   ├── assets/                # Shared assets (CSS, fonts, images, scripts)
│   ├── css/uTPro/             # Site CSS (variables, layout, main, critical)
│   ├── scripts/uTPro/         # Site JS (main, util, select-language)
│   └── uploads/               # Media uploads
├── Program.cs                 # Entry point (minimal — delegates to Startup/)
├── appsettings.json           # Production configuration
└── appsettings.Development.json # Development overrides

Program.cs — Clean Entry Point

The application entry point is intentionally minimal. All configuration logic is organized into extension methods in the Startup/ folder:

var setup = HostingSetup.BuildWebApplicationOptions(args);
var builder = WebApplication.CreateBuilder(setup);

builder.ConfigureAppSettings();                               // Per-app overlay
builder.ConfigureTempPath();                                  // Hosting: TMP/TEMP
builder.ConfigureMediaPath();                                 // Hosting: shared media
builder.ConfigureUmbraco();                                   // Umbraco CMS
builder.Services.AddPerformanceServices(builder.Environment); // Performance
builder.Services.AddSecurityServices(builder);                // Security
builder.Services.AddForwardedHeadersConfig(builder);          // Real client IP/scheme
builder.Services.AddRenderingDefaults();                      // MVC
builder.Services.AddControllers();
builder.Services.AddBlockPreviewServices();                   // Block Preview

var app = builder.Build();
await app.BootUmbracoAsync();
app.ConfigurePipeline();                                      // Middleware
await app.RunAsync();

Each Startup/*.cs file is self-contained and can be modified independently.

Middleware Pipeline Order

Configured in Startup/PipelineSetup.cs:

1. Forwarded Headers — rewrites client IP/scheme from X-Forwarded-*
2. Browser Cache-Control — stale-while-revalidate for HTML pages
3. HTTPS Redirection
4. Status Code Pages — UseStatusCodePagesWithReExecute("/error/{0}")
5. WebOptimizer — CSS/JS minification (must be before StaticFiles)
6. Static Files — immutable 1-year cache for /assets/, /css/, /scripts/; 7-day for /uploads/
7. WebMarkupMin — HTML minification + Brotli/GZip compression
8. Output Cache — stores rendered responses in memory (120s TTL)
9. Cookie Policy
10. uTPro Middleware — request localization + selective buffering
11. Umbraco Pipeline — BackOffice + Website routing + Security headers
12. MapControllers — MVC endpoint routing

Technology Stack