HackerOs.MobileShell.Blazor 2.2.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package HackerOs.MobileShell.Blazor --version 2.2.1
                    
NuGet\Install-Package HackerOs.MobileShell.Blazor -Version 2.2.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="HackerOs.MobileShell.Blazor" Version="2.2.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="HackerOs.MobileShell.Blazor" Version="2.2.1" />
                    
Directory.Packages.props
<PackageReference Include="HackerOs.MobileShell.Blazor" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add HackerOs.MobileShell.Blazor --version 2.2.1
                    
#r "nuget: HackerOs.MobileShell.Blazor, 2.2.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package HackerOs.MobileShell.Blazor@2.2.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=HackerOs.MobileShell.Blazor&version=2.2.1
                    
Install as a Cake Addin
#tool nuget:?package=HackerOs.MobileShell.Blazor&version=2.2.1
                    
Install as a Cake Tool

HackerOs.MobileShell.Blazor

Mobile shell chrome Razor components, driven by host-supplied contracts the same way HackerOs.Taskbar.Blazor drives the Desktop taskbar. Mobile has no taskbar (archived mobile plan §7.2), so this is a sibling package rather than a modification of HackerOs.Taskbar.Blazor.

MobileSystemNavigationBar

An Android-inspired bottom bar with three buttons — Triangle/Back, Circle/Home (a pill with the iOS theme), Square/Recent — each at least 44×44 CSS pixels and respecting env(safe-area-inset-*). The bar owns only the trigger buttons; what Back/Home/Recent actually do is entirely up to the host's IMobileNavigationCommands implementation.

<MobileSystemNavigationBar Commands="_navigationCommands" Options="_options" />

Unlike HackerOs.Taskbar.Blazor's optional contract parameters, Commands is required — the Mobile shell has no floating-chrome equivalent for these three actions, so a bar with nothing to dispatch to is a host configuration error, not a legitimately reduced state.

MobileSystemNavigationBarOptions carries only the three buttons' accessible labels, mirroring TaskbarOptions.

This package supplies the navigation controls and Recent surface. The host owns Back's ordered semantics (overlay → app handler → navigation history → Home). HackerOS also recognizes an upward gesture starting on the Home control to open its application drawer. Home pages, the pinned app dock and mouse assistance belong to Platform Blazor; see mobile Home and ADR 0165.

Localization

The package's texts (accessible labels, Back/Home/Recent, the Recent surface) live in Resources/Strings.resx (English) and Resources/Strings.fr.resx (French), read through HackerOs.Theming.Blazor.Localization.PackageStringLocalizer (ADR 0104): a host that registers an IStringLocalizer<T> (HackerOS registers its session-language SessionStringLocalizer<T>) gets its language; a host without localization gets English.

Every label of MobileSystemNavigationBarOptions and MobileRecentSurfaceOptions is now string?: a host value wins, null (the default) uses the localized package text.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on HackerOs.MobileShell.Blazor:

Package Downloads
HackerOs.Platform.Blazor

HackerOS Blazor shell: desktop, launcher, window launching, dialogs and lazy app loading. For composing an OS host.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.2.2 97 11/1/2026
2.2.1 108 11/1/2026
2.2.0 107 10/31/2026
2.1.0 136 10/26/2026

HackerOS 2.2.1, changes for app developers:
- Mouse Back and Forward buttons in apps. The mouse Back button, Alt+← and the phone's Back (Android button or gesture, iOS swipe) now go to the active app instead of moving the browser tab back and leaving HackerOS; the mouse Forward button and Alt+→ go forward. On a phone, Back follows the ◁ button. Apps receive them through IAppBackHandler and the new IAppForwardHandler, with the new MouseButton and SystemBack sources.
- App packages carry their satellite assemblies. HackerOsPack puts the satellite assemblies of the app's own assemblies in the package at lib/<culture>/<assembly>.resources.dll; the OS checks them and loads them before the app's first render.
- HackerOsPack packs every static resource of an app. The package now holds the whole wwwroot/, the collocated .razor.js files and the scoped CSS bundle, declared in the package's manifest with their SHA-256; the publish workflow of the hackeros-solution template copies that manifest into the catalog folder.
- Signing tool for app authors. dotnet build -t:HackerOsKeyGen creates an author's signing key, HackerOsPack signs each package with the HACKEROS_APP_SIGNING_KEY secret, and the hackeros-solution template publishes the signed packages on the hackeros-packages branch on each version tag. Administrators require an author's signature by adding their public key to [signing-keys].
Release notes: https://github.com/Kazo-ca/HackerOs/releases/tag/v2.2.1