We are happy to release ABP version 10.0 RC (Release Candidate). This blog post introduces the new features and important changes in this new version.

Try this version and provide feedback for a more stable version of ABP v10.0! Thanks to you in advance.

Get Started with the 10.0 RC

You can check the Get Started page to see how to get started with ABP. You can either download ABP Studio (recommended, if you prefer a user-friendly GUI application - desktop application) or use the ABP CLI.

By default, ABP Studio uses stable versions to create solutions. Therefore, if you want to create a solution with a preview version, first you need to create a solution and then switch your solution to the preview version from the ABP Studio UI:

Migration Guide

There are a few breaking changes in this version that may affect your application. Please read the migration guide carefully, if you are upgrading from v9.3 or earlier: ABP Version 10.0 Migration Guide.

What's New with ABP v10.0?

In this section, I will introduce some major features released in this version.
Here is a brief list of titles explained in the next sections:

• Upgraded to .NET 10.0
• Upgraded to Blazorise 1.8.2
• New Module: Workflow (Elsa)
• New Object Mapper: Mapperly
• Localization: Nested object support in JSON files
• Support EF Core Shared Entity Types on Repositories
• Add failure retry policy to InboxProcessor
• Migrate to New Esbuild-based Angular Builder
• Angular SSR support

Upgraded to .NET 10.0

We've upgraded ABP to .NET 10.0, so you need to move your solutions to .NET 10.0 if you want to use ABP 10.0.

Since the stable version of .NET 10 hasn't been released yet, we upgraded ABP to .NET v10.0-rc.1. Stable NET 10 is scheduled to launch as a Long-Term Support (LTS) release during .NET Conf 2025, which takes place November 11-13, 2025. We'll update the ABP Platform to the .NET 10 as soon as possible official .NET 10 release is completed.

Upgraded to Blazorise v1.8.2

Upgraded the Blazorise library to v1.8.2 for Blazor UI. If you are upgrading your project to v10.0 RC, please ensure that all the Blazorise-related packages are using v1.8.2 in your application. Otherwise, you might get errors due to incompatible versions.

See #23717 for the updated NuGet packages.

New Module: Workflow (Elsa)

ABP now ships a Workflow module that integrates Elsa Workflows to build visual, long-running, event-driven workflows in your ABP solutions (monolith or microservices). It provides seamless integration with ABP authentication/authorization, distributed event bus, persistence, background processing and includes support for hybrid UIs via Elsa Studio.

For a hands-on reference showcasing an end-to-end order/payment workflow across services, see the sample: Elsa Workflows - Sample Workflow Demo. For capabilities, installation and configuration details (activities, storage, hosting, dashboard), see the module docs: Workflow (Elsa) module.

New Object Mapper: Mapperly

ABP modules now use Mapperly as the default object-to-object mapper. Mapperly is a compile-time, source generator–based mapper that removes runtime reflection and offers better performance with simpler maintenance. For background and implementation details, see the planning issue and the PR: Switch to another object mapping library and Use Mapperly to replace AutoMapper in all modules.

The Volo.Abp.AutoMapper package remains available for backward compatibility. You can keep using AutoMapper in your solutions, but you are responsible for obtaining and managing its license if needed. For upgrade guidance and practical steps, follow the migration guide: AutoMapper to Mapperly.

Localization: Nested object support in JSON files

ABP now supports nested objects (and arrays) in JSON localization files, allowing you to organize translations hierarchically and access them using the double underscore (__) separator. This improves maintainability for larger resource files and aligns lookups with familiar key paths.

See the PR for details: feat(l8n): add support for nested objects in localization files.

Declaration (nested objects):

{
  "culture": "en",
  "texts": {
    "MyNestedTranslation": {
      "SomeKey": "Some nested value",
      "SomeOtherKey": "Some other nested value"
    }
  }
}

Usage:

L["MyNestedTranslation__SomeKey"];
L["MyNestedTranslation__SomeOtherKey"];

Declaration (arrays):

{
  "culture": "en",
  "texts": {
    "Menu": {
      "Items": ["Home", "About", "Contact"]
    }
  }
}

Usage:

L["Menu__Items__0"]; // Home
L["Menu__Items__2"]; // Contact

Support EF Core Shared Entity Types on Repositories

ABP repositories now support EF Core shared-type entity types by allowing a custom entity name to be set on a repository before performing operations. Internally, this uses EF Core's DbContext.Set<T>(string name) to target the correct DbSet/table for the same CLR type, enabling scenarios like per-tenant tables, archives, or partitioning, and you can switch the target at runtime. See the PR: Support EF Core Shared Entity Types on Repositories and the EF Core documentation on shared-type entity types.

Example:

// Set the shared entity name so repository operations target that table
var repo = serviceProvider.GetRequiredService<IRepository<MyEntity, Guid>>();
repo.SetCustomEntityName("MyEntity_TenantA");
var list = await repo.GetListAsync();

// Switch to another shared name later on the same instance
repo.SetCustomEntityName("MyEntity_Archive");
await repo.InsertAsync(new MyEntity { /* ... */ });

Add failure retry policy to InboxProcessor

InboxProcessor now supports configurable failure handling strategies per event: Retry (default; reprocess in the next cycle), RetryLater (skip the failing event and retry it later with exponential backoff; the backoff factor and maximum retries are configurable), and Discard (drop the failing event). This prevents a single failing handler from blocking subsequent events and improves resiliency.

Note: This is a breaking change because IncomingEvent entity properties were updated. See the PR for details: Add failure retry policy to InboxProcessor.

Migrate to New Esbuild-based Angular Builder

We've migrated ABP Angular templates and packages to Angular's new esbuild-based build system (introduced in Angular 17+ and fully supported in Angular 20) to deliver faster builds, modern ESM support, built-in SSR/prerender capabilities, and a better development experience. This change is non-breaking for existing apps. See the tracking issue and PR: Angular - Migrate to New Esbuild-based Angular Builder, feat: Update Angular templates to Angular 20 new build system.

Key updates in templates/config:

• Builder switched from @angular-devkit/build-angular:browser to @angular-devkit/build-angular:application.
• main option replaced by browser; polyfills moved to array form.
• TypeScript updated to es2020 with esModuleInterop: true; module target esnext.

More Angular updates:

• Unit tests have been updated for the new builder and configuration: #23460.

Warnings:

• Constructor injections migrated to Angular's inject() function. If you extend a class and previously called super(...) with injected params, remove those parameters. See: Angular inject() migration.
• provideLogo and withEnvironmentOptions have moved from LeptonX packages to @abp/ng.theme-shared.
• If you use the new application builder and have tsconfig.json path mappings that point into node_modules, remove those mappings and prefer symlinks instead. See a symlink reference: Creating symbolic links.

Angular SSR support

ABP Angular templates now support Server-Side Rendering (SSR) with the Angular Application Builder, enabling hybrid rendering (SSR + CSR) for improved first paint, SEO and perceived performance. This includes SSR-safe platform checks (no direct window/location/localStorage), OIDC auth compatibility via cookie-backed storage, and TransferState to prevent duplicate HTTP GETs during hydration. For implementation highlights and usage (including how to run the SSR dev server and the transferStateInterceptor), see the issue and PR: Angular SSR, Hybrid Rendering & Application Builder.

See Angular's official guide for details on hybrid rendering (prerender + SSR + CSR): Angular SSR and on the builder migration: Angular build system migration.

Community News

Recent Events

We recently hosted two sessions of ABP Community Talks:

Community Talks 2025.06: Microservices with ABP Template

The Easiest Way to Get Started with Microservices on .NET Using ABP Microservice Solution Template: a deep dive into ABP’s microservice template, showing how ABP Studio streamlines creating, running, and scaling distributed systems. See the event page: Community Talks: Microservices with ABP Template.

Community Talks 2025.07: Developer-Friendly CMS for .NET

Beyond WordPress: A Developer-Friendly CMS for .NET: an overview of building custom web apps with ABP CMS Kit, integrating content management with your application code. Learn more: Community Talks: Developer-Friendly CMS for .NET.

Weekly Webinar: Discover ABP Platform

We’ve started a weekly live webinar series designed for developers who want to get the most out of the ABP Platform. This event is designed for those new to ABP to help you understand its core features, capabilities, and licensing models.

Every webinar features live coding demos, practical examples, and an open Q&A segment where you can get your questions answered directly by the ABP team. Whether you’re just starting with ABP or looking to explore advanced scenarios, these sessions will help you build better apps faster.

👉 Register here to join an upcoming session!

New ABP Community Articles

There are exciting articles contributed by the ABP community as always. I will highlight some of them here:

• Alper Ebiçoğlu:
  • High-Performance .NET Libraries You Didn’t Know You Needed
  • .NET 10: What You Need to Know (LTS Release, Coming November 2025)
  • Best Free Alternatives to AutoMapper in .NET — Why We Moved to Mapperly
• Liming Ma:
  • Keep Track of Your Users in an ASP.NET Core Application
  • App Services vs Domain Services
  • Using Hangfire Dashboard in ABP API Website
• Fahri Gedik:
  • Backward‑Compatible REST APIs in .NET Microservices
  • Best Practices for Designing Backward‑Compatible REST APIs in a Microservice Solution for .NET Developers
  • Stepbystep AWS Secrets Manager Integration in ABP
• Engincan Veske:
  • Building a Permission-Based Authorization System for ASP.NET Core
  • Where and How to Store Your Blob Objects in .NET
• Salih Özkara:
  • Truly Layering a .NET Application Based on DDD Principles
• Kori Francis:
  • ABP Postmark Email Integration, Templated Emails
  • Universal Redis Configuration in ABP Aspire Deployment
• Sajankumar Vijayan:
  • Multi-tenant SaaS apps, Cloudflare DNS
• Selman Koc:
  • Azure DevOps, CI/CD pipelines, Azure DevOps best practices
• Sümeyye Kurtuluş:
  • ABP Now Supports Angular Standalone Applications
  • Supercharge your Angular app: A developer's guide to unlock
• Mansur Besleney:
  • Demystified Aggregates in DDD & .NET: From Theory to Practice
  • How to Build Persistent Background Jobs with ABP Framework and Quartz
  • Angular Application Builder: Transitioning from Webpack to Esbuild
• Muhammet Ali Özkaya:
  • Implementing Unit of Work with ASP.NET Core
• Enis Necipoğlu:
  • Integration Services Explained: What They Are & When to Use
• Berkan Şaşmaz:
  • How to Dynamically Set the Connection String in EF Core
• Emre Kara:
  • A Developer's Guide to Distributed Event Buses in .NET
• Oğuzhan Ağır:
  • In-Memory Background Job Queue in ASP.NET Core
• Alperen Samurlu:
  • How Can We Apply the DRY Principle in a Better Way?
• Ahmet Çelik:
  • Best Practices Guide for REST API Design
• Elanur Oğuz:
  • Web Design Basics for Graphic Designers Who Don't Code
• Seda Şen:
  • Color Psychology in Web Design
• Halime Karayay:
  • 10 Modern HTML CSS Techniques Every Designer Should Know
• Anto Subash:
  • ABP React CMS Module: Building Dynamic Pages with Puck
• Yağmur Çelik:
  • Integration Testing Best Practices for Building a Robust API
• Suhaib Mousa:
  • Visual Studio 2026 - What's New and Why I'm Excited About It
• Alex Maiereanu:
  • ABP-Hangfire-AzurePostgreSQL
• Jack Fistelmann:
  • ABP and maildev
• Tarık Özdemir:
  • AI-First Architecture for .NET Projects: A Modern Blueprint
• Prabhjot Singh:
  • Switching from Project References to Package References
• Yunus Emre Kalkan:
  • New in ABP Studio: Docker Container Management
• Burak Demir:
  • Solving MongoDB GUID Issues After an ABP Framework Upgrade

Thanks to the ABP Community for all the content they have published. You can also post your ABP-related (text or video) content to the ABP Community.

Conclusion

This version comes with some new features and a lot of enhancements to the existing features. You can see the Road Map documentation to learn about the release schedule and planned features for the next releases. Please try ABP v10.0 RC and provide feedback to help us release a more stable version.

Thanks for being a part of this community!