What’s New in .NET MAUI 2025 – Biggest Features & Tips

// Opt‑in once per AppBuilder and forget
MauiApp.CreateBuilder()
   .UseSkiaImageDecoders()  // new extension in Microsoft.Maui.Graphics.Skia
   .Build();

class WaveformCanvas : GraphicsDrawable
{
    [ObservableProperty] IList<float> _samples = new List<float>();

    public override void Draw(ICanvas canvas, RectF dirty)
    {
        var path = new PathF();
        var dx   = dirty.Width / (Samples.Count - 1);
        for (int i = 0; i < Samples.Count; i++)
            path.LineTo(i * dx, dirty.Height / 2 - Samples[i]);
        canvas.StrokeSize = 2;
        canvas.DrawPath(path);
    }
}

<DataGrid ItemsSource="{Binding Orders}" RowSwipeMode="Reveal">
    <DataGrid.SwipeActions>
        <SwipeAction Icon="delete" Command="{Binding RemoveOrder}" />
    </DataGrid.SwipeActions>
</DataGrid>

<CarouselView
    ItemsSource="{Binding Photos}"
    HeightRequest="400"
    SnapPointsAlignment="Center"
    SnapPointsType="MandatorySingle"
    IsLooping="True"> <!-- .NET 9 -->
    <CarouselView.ItemTemplate>
        <DataTemplate>
            <Image Aspect="AspectFill" Source="{Binding Url}" />
        </DataTemplate>
    </CarouselView.ItemTemplate>
</CarouselView>

<CarouselView
    ItemsSource="{Binding Stories}"
    ItemsLayout="VerticalList"
    SnapPointsAlignment="Start"  <!-- snaps top‑aligned like TikTok -->
    SnapPointsType="MandatorySingle">
    <CarouselView.ItemTemplate>
        <DataTemplate>
            <local:StoryCard />
        </DataTemplate>
    </CarouselView.ItemTemplate>
</CarouselView>

void OnPositionChanged(object sender, PositionChangedEventArgs e)
{
    // Prefetch next page once the user swipes past 75 % of items
    if (e.CurrentPosition > Items.Count * 0.75 && !IsBusy)
        _ = LoadMoreAsync();
}

<CarouselView PositionChanged="OnPositionChanged" />

<SkeletonView IsBusy="{Binding IsLoading}">
    <Image HeightRequest="240" WidthRequest="240" />
    <Label HeightRequest="20" WidthRequest="120" />
    <Label HeightRequest="14" WidthRequest="180" />
</SkeletonView>

<RefreshContainer Command="{Binding RefreshCommand}">
    <ScrollView>
        <!-- Long form -->
    </ScrollView>
</RefreshContainer>

[RelayCommand]
async Task RefreshAsync()
{
    await Task.Delay(1200);   // simulate I/O
    await LoadDataAsync();
}

<ChipGroup ItemsSource="{Binding Tags}" SelectedItem="{Binding SelectedTag}">
    <ChipGroup.ItemTemplate>
        <DataTemplate>
            <Chip Text="{Binding}" />
        </DataTemplate>
    </ChipGroup.ItemTemplate>
</ChipGroup>

<SegmentedButton SelectedIndex="{Binding ViewModeIndex}">
    <SegmentedButton.Items>
        <Button Text="List" />
        <Button Text="Grid" />
        <Button Text="Map" />
    </SegmentedButton.Items>
</SegmentedButton>

<CompactChart ItemsSource="{Binding Prices}" StrokeThickness="2" HeightRequest="56" />

<SplitView IsPaneOpen="{Binding IsMenuOpen}">
    <SplitView.Pane>
        <local:MenuPage />
    </SplitView.Pane>
    <SplitView.Content>
        <local:DashboardPage />
    </SplitView.Content>
</SplitView>

// AppShell.cs (.NET 9+)
Routing.Register("portfolio/{symbol}/{period}", typeof(PortfolioPage));
Routing.Register("order/{id:int}/{action:regex(^(edit|view)$)}", typeof(OrderPage));

[QueryProperty(nameof(Symbol), "symbol")]
[QueryProperty(nameof(Period), "period")]
public partial class PortfolioPage : ContentPage
{
    public string Symbol { get; set; } = "BTC";
    public string Period { get; set; } = "daily";

    protected override void OnAppearing()
    {
        Title = $"{Symbol} – {Period}";
        base.OnAppearing();
    }
}

public sealed class AuthGuard : IRouteGuard
{
    readonly IAuthService _auth;
    public AuthGuard(IAuthService auth) => _auth = auth;

    public async ValueTask<bool> CanNavigateToAsync(INavigationContext ctx,
                                                   CancellationToken token = default)
        => await _auth.IsLoggedInAsync();
}

// Registration – guard applies only to the secure route
Routing.Register("secure/profile", typeof(ProfilePage), new AuthGuard());

Routing.Register("settings", typeof(SettingsPage), new AuthGuard(), new DirtyFormGuard());

<Shell
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    FlyoutBehavior="Locked">
    <TabBar>
        <ShellContent Route="dashboard"
                      ContentTemplate="{DataTemplate local:DashboardPage}" />

        <ShellSection Title="Products" Icon="products.png">
            <ShellContent ContentTemplate="{DataTemplate local:ProductListPage}" />
            <ShellContent Route="details"
                          ContentTemplate="{DataTemplate local:ProductDetailsPage}" />
        </ShellSection>
    </TabBar>
</Shell>

<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <Shell.Resources>
        <TransitionMap x:Key="ZoomFast" Duration="140" ScaleFrom="0.8" />
    </Shell.Resources>

    <ContentPage x:Class="Demo.DetailsPage"
                 Shell.NavTransition="ZoomFast" />
</Shell>

[RegisterRoute("details")]
[ShellNavTransition(ShellTransitionType.FadeIn)]
public partial class DetailsPage : ContentPage { }

public class OrdersViewModel
{
    readonly INavigationService _nav;
    public OrdersViewModel(INavigationService nav) => _nav = nav;

    public Task ShowOrderAsync(Order order) =>
        _nav.GoToAsync($"order/{order.Id}/view");
}

await AppActions.SetAsync(new AppAction("scan", "Start QR Scan", icon: "scan.png"));

App.Current.AppAction += async (_, e) =>
{
    if (e.AppAction.Id == "scan")
        await Shell.Current.GoToAsync("//scanner");
};

# Installs templates if missing
dotnet new install Microsoft.DotNet.Aspire.Templates

# Create –maui flag adds a MAUI client wired with gRPC stubs
dotnet new aspire -o Contoso.Demo --maui

name: contoso-demo
services:
  mobile:
    project: mobile/Contoso.Demo.Mobile.csproj
    bindings:
      - type: grpc
        to: api
  api:
    project: api/Contoso.Demo.Api.csproj
    env:
      ASPNETCORE_ENVIRONMENT: Production
    replicas: 2

dotnet aspire run   # Hot reloads both tiers; MAUI device connects via Dev Tunnels

dotnet aspire deploy --env prod --registry ghcr.io/contoso

dotnet new maui --ci github   # or --ci azure

name: build‑maui
on:
  push:
    branches: [main]
jobs:
  build:
    runs‑on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [windows‑latest, macos‑14]
    steps:
    - uses: actions/checkout@v4
    - uses: actions/setup‑dotnet@v4
      with:
        dotnet‑version: '9.0.x'
    - name: Install MAUI workloads
      run: dotnet workload install maui‑android maui‑ios
    - name: Build – Release AOT
      run: >
        dotnet build src/Contoso.Demo.sln -c Release
        /p:PublishTrimmed=true /p:PublishAot=true
    - name: Upload artifacts
      uses: actions/upload‑artifact@v4
      with:
        name: mobile‑binaries
        path: |
          **/bin/Release/*/*.apk
          **/bin/Release/*/*.ipa

trigger: [main]
pool:
  vmImage: 'macos‑latest'
steps:
- task: UseDotNet@2
  inputs:
    packageType: sdk
    version: 9.0.x
- script: dotnet workload install maui‑android maui‑ios
  displayName: 'Install Workloads'
- script: dotnet publish src/Contoso.Demo.Mobile.csproj -c Release -f net9.0‑ios
  displayName: 'Publish iOS'
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'AppCenterConn'
    appSlug: 'contoso/ContosoDemo‑iOS'
    appFile: '$(build.artifactstagingdirectory)/**/*.ipa'
    releaseNotesOption: 'input'
    releaseNotesInput: 'Automated build $(Build.BuildNumber)'

// VS auto‑generates connection string, just hit F5 – diagnostics flow back via
// Azure Relay, no firewall holes required.

vsdevtunnel create --allow-anonymous --port 5000

{
  "packagePath": "**/ContosoDemo.apk",
  "track": "beta",
  "rollout": 0.1,
  "changelog": "Faster login, Aspire integration"
}