TechniumNavigation 1.1.3

TechniumNavigation

A navigation library for .NET MAUI applications that provides simplified navigation patterns and parameter passing capabilities.

Features

• Simple navigation service with type-safe parameter passing
• Page registration and management
• Navigation helpers and extensions
• Support for iOS and Android platforms
• Built-in navigation parameters handling

Installation

Install the package via NuGet Package Manager:

Install-Package TechniumNavigation

Or via .NET CLI:

dotnet add package TechniumNavigation

Usage

Basic Navigation

// Navigate to MainPage
await _navigationService.NavigateAsync("Main");
// or
await _navigationService.NavigateAsync("MainPage");

// Navigate with parameters to UserDetailPage
var parameters = new NavigationParameters();
parameters.Add("userId", 123);

await _navigationService.NavigateAsync("UserDetail", parameters);
// or
await _navigationService.NavigateAsync("UserDetailPage", parameters);

Page Registration

// Register pages in your MauiProgram.cs
public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseCustomNavigation(navigationBuilder =>
            {
                // Register pages with their view models (optional)
                navigationBuilder.RegisterPage<NavigationPage>();
                navigationBuilder.RegisterPage<MainPage, MainPageViewModel>();
                
                // Assign the LoaderPage as the initial page
                navigationBuilder.MainPage = NavigationConstants.Loader;
            })
            
        return builder.Build();
    }
}

App configuration

<navigation:TechniumApp
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:navigation="clr-namespace:TechniumNavigation;assembly=TechniumNavigation">

public partial class App : TechniumApp
{
    public App()
    {
        InitializeComponent();
    }
}

API Reference

INavigationService

The main navigation service interface providing:

• NavigateAsync(string path, INavigationParameters parameters = null) - Navigate with parameters
• GoBackAsync(INavigationParameters parameters = null) - Navigate back in the navigation stack
• GoBackToRootAsync(INavigationParameters parameters = null) - Navigate back to the root page

NavigationParameters

Type-safe parameter container for passing data between pages.

License

This project is licensed under the MIT License.