It is time for version 1.1.4

.github/workflows/running-unit-tests.yml

@@ -33,6 +33,9 @@ jobs:
             ${{ env.DEFAULT_DOTNET_VERSION }}
             10.0.x
 
+      - name: Restore workloads
+        run: dotnet workload restore
+
       - name: Restore dependencies
         run: dotnet restore
 

.gitignore

@@ -6,6 +6,9 @@
 # dotenv files
 .env
 
+# Local MAUI mobile configuration overrides
+src/NoteBookmark.MauiApp/wwwroot/appsettings.Development.json
+
 # User-specific files
 *.rsuser
 *.suo
@@ -510,15 +513,15 @@ todos/
 .copilot/
 
 # Squad/Agent files
-.github/agents/
-# Squad (local AI team - not committed)
-.ai-team/
+.github/agents/
+# Squad (local AI team - not committed)
+.ai-team/
 
 src/NoteBookmark.BlazorApp/Data/
-# Squad: ignore runtime state (logs, inbox, sessions)
-.squad/orchestration-log/
-.squad/log/
-.squad/decisions/inbox/
-.squad/sessions/
-# Squad: SubSquad activation file (local to this machine)
-.squad-workstream
+# Squad: ignore runtime state (logs, inbox, sessions)
+.squad/orchestration-log/
+.squad/log/
+.squad/decisions/inbox/
+.squad/sessions/
+# Squad: SubSquad activation file (local to this machine)
+.squad-workstream

Directory.Build.props

@@ -1,6 +1,6 @@
 <Project>
   <PropertyGroup>
-    <Version>1.1.2</Version>
+    <Version>1.1.4</Version>
     <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>

Directory.Packages.props

@@ -30,6 +30,11 @@
     <PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.14.0" />
     <PackageVersion Include="OpenTelemetry.Instrumentation.Http" Version="1.14.0" />
     <PackageVersion Include="OpenTelemetry.Instrumentation.Runtime" Version="1.14.0" />
+    <!-- MAUI packages -->
+    <PackageVersion Include="Microsoft.Maui.Controls" Version="10.0.20" />
+    <PackageVersion Include="Microsoft.AspNetCore.Components.WebView.Maui" Version="10.0.20" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Debug" Version="10.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.Json" Version="10.0.1" />
     <!-- Other packages -->
     <PackageVersion Include="HtmlAgilityPack" Version="1.12.4" />
     <PackageVersion Include="Markdig" Version="0.44.0" />
@@ -39,6 +44,7 @@
     <PackageVersion Include="System.Text.Json" Version="9.0.10" />
     <PackageVersion Include="Reka.SDK" Version="0.1.0" />
     <!-- Test packages -->
+    <PackageVersion Include="bunit" Version="2.7.2" />
     <PackageVersion Include="coverlet.collector" Version="6.0.4" />
     <PackageVersion Include="FluentAssertions" Version="8.8.0" />
     <PackageVersion Include="Moq" Version="4.20.72" />

NoteBookmark.sln

@@ -21,6 +21,12 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NoteBookmark.AIServices.Tests", "src\NoteBookmark.AIServices.Tests\NoteBookmark.AIServices.Tests.csproj", "{13B6E1BC-4B32-4082-A080-FE443F598967}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NoteBookmark.BlazorApp.Tests", "src\NoteBookmark.BlazorApp.Tests\NoteBookmark.BlazorApp.Tests.csproj", "{C04232AF-A144-47C9-B4D4-3259C61E5ABC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NoteBookmark.SharedUI", "src\NoteBookmark.SharedUI\NoteBookmark.SharedUI.csproj", "{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NoteBookmark.MauiApp", "src\NoteBookmark.MauiApp\NoteBookmark.MauiApp.csproj", "{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -127,12 +133,51 @@ Global
 		{13B6E1BC-4B32-4082-A080-FE443F598967}.Release|x64.Build.0 = Release|Any CPU
 		{13B6E1BC-4B32-4082-A080-FE443F598967}.Release|x86.ActiveCfg = Release|Any CPU
 		{13B6E1BC-4B32-4082-A080-FE443F598967}.Release|x86.Build.0 = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|x64.Build.0 = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Debug|x86.Build.0 = Debug|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|x64.ActiveCfg = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|x64.Build.0 = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|x86.ActiveCfg = Release|Any CPU
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC}.Release|x86.Build.0 = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|x64.Build.0 = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Debug|x86.Build.0 = Debug|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|x64.ActiveCfg = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|x64.Build.0 = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|x86.ActiveCfg = Release|Any CPU
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA}.Release|x86.Build.0 = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|x64.Build.0 = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Debug|x86.Build.0 = Debug|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|x64.ActiveCfg = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|x64.Build.0 = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|x86.ActiveCfg = Release|Any CPU
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
 	GlobalSection(NestedProjects) = preSolution
 		{13B6E1BC-4B32-4082-A080-FE443F598967} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{C04232AF-A144-47C9-B4D4-3259C61E5ABC} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{1AD790B0-8C91-468A-B21E-C2C5A4F7E1CA} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{9FFD0186-2C97-40F7-9CA1-EDEC3C2A0EF3} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {D59FFF09-97C3-47EF-B64D-B014BFA22C80}

docs/maui-android-dev-setup.md

@@ -0,0 +1,178 @@
+# MAUI Android Development Environment Setup
+
+This guide covers setting up a local development environment for the NoteBookmark MAUI Android app.
+
+**Platform:** Debian 13 
+
+## Step 1 — Install JDK 21
+
+```bash
+sudo apt install openjdk-21-jdk
+```
+
+Add `JAVA_HOME` to your shell config (`~/.zshrc` or `~/.bashrc`):
+
+```bash
+echo 'export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64' >> ~/.zshrc
+source ~/.zshrc
+```
+
+Verify:
+
+```bash
+java -version
+```
+
+## Step 2 — Install .NET MAUI Android workload
+
+.NET 9 or 10 must already be installed. Then:
+
+```bash
+dotnet workload install maui-android
+```
+
+This downloads ~2 GB and takes a few minutes.
+
+Verify:
+
+```bash
+dotnet workload list
+```
+
+You should see `maui-android` in the output.
+
+
+## Step 3 — Install Android command-line tools
+
+1. Download the **Command line tools only** package from:
+   https://developer.android.com/studio#command-tools
+   *(look for "Command line tools only" at the bottom of the page)*
+
+2. Extract and place them in the expected location:
+
+```bash
+mkdir -p ~/Android/Sdk/cmdline-tools
+unzip ~/Downloads/commandlinetools-linux-*_latest.zip -d ~/Android/Sdk/cmdline-tools
+mv ~/Android/Sdk/cmdline-tools/cmdline-tools ~/Android/Sdk/cmdline-tools/latest
+```
+
+3. Add `ANDROID_HOME` to your shell config:
+
+```bash
+cat >> ~/.zshrc << 'EOF'
+
+# Android SDK
+export ANDROID_HOME=$HOME/Android/Sdk
+export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$PATH
+EOF
+source ~/.zshrc
+```
+
+Verify:
+
+```bash
+sdkmanager --version
+```
+
+
+## Step 4 — Install SDK packages
+
+Accept all licenses first:
+
+```bash
+sdkmanager --licenses
+```
+
+Then install the required packages (downloads ~2–3 GB):
+
+```bash
+sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0" "emulator" "system-images;android-35;google_apis;x86_64"
+```
+
+Verify everything installed:
+
+```bash
+sdkmanager --list_installed
+```
+
+You should see `platform-tools`, `platforms;android-35`, `build-tools;35.0.0`, `emulator`, and `system-images;android-35;google_apis;x86_64`.
+
+
+## Step 5 — Create an Android Virtual Device (AVD)
+
+```bash
+avdmanager create avd -n maui_dev -k "system-images;android-35;google_apis;x86_64"
+```
+
+When prompted *"Do you wish to create a custom hardware profile?"*, answer `no`.
+
+Verify the AVD was created:
+
+```bash
+avdmanager list avd
+```
+
+
+## Step 6 — Install VS Code extensions
+
+You need the official .NET MAUI extension on top of the standard C# tooling.
+
+Required extensions:
+
+| Extension | Purpose |
+|---|---|
+| `ms-dotnettools.csharp` | C# language support |
+| `ms-dotnettools.csdevkit` | Solution explorer, test runner |
+| `ms-dotnettools.dotnet-maui` | MAUI project support, Android deploy/debug |
+
+Install the MAUI extension from the terminal:
+
+```bash
+code --install-extension ms-dotnettools.dotnet-maui
+```
+
+Or search **".NET MAUI"** in the VS Code Extensions panel.
+
+The MAUI extension adds device selection (emulator or physical device), one-click launch/debug, and MAUI-specific C# and XAML tooling.
+
+
+## Step 7 — Verify the build
+
+From the repo root:
+
+```bash
+dotnet build src/NoteBookmark.MauiApp \
+  /p:RuntimeIdentifier=android-arm64 \
+  /p:AndroidSdkDirectory=$HOME/Android/Sdk
+```
+
+
+## Running the emulator
+
+```bash
+$ANDROID_HOME/emulator/emulator -avd maui_dev
+```
+
+KVM hardware acceleration is enabled automatically when `/dev/kvm` is available, which makes the emulator fast and responsive.
+
+
+## Troubleshooting
+
+**`JAVA_HOME` is set to an invalid directory**
+Make sure the path ends in `amd64` (not `amd6`). Check with:
+```bash
+ls /usr/lib/jvm/
+```
+Use the exact folder name shown.
+
+**`sdkmanager: command not found`**
+Run `source ~/.zshrc` to reload your PATH, or open a new terminal.
+
+**`avdmanager: Package path is not valid. Valid system image paths are: null`**
+The system image wasn't downloaded. Re-run:
+```bash
+sdkmanager "emulator" "system-images;android-35;google_apis;x86_64"
+```
+
+**`NETSDK1082` error during build**
+This is a known issue with MAUI + Android on Linux. The `.csproj` in `NoteBookmark.MauiApp` already includes a workaround — ensure you're on the correct branch.