BooksMobile (Avalonia Android + Windows)

name: BooksMobile Avalonia overview: Build an Avalonia Android+Windows BooksMobile app that signs into GitHub via device-flow OAuth (GitHub app / 1Password passkeys), mirrors frankhaugen/books content into platform app-data storage, and exposes Pull plus Save/Commit/Push-all-in-one — backed by new Novolis.Avalonia.Mobile* and Novolis.IO.GitHub packages, local deploy scripts only (no release catalog). todos:

• id: mobile-pkgs

content: Add Novolis.Avalonia.Mobile + .Android + .Desktop (secure store, app paths, browser/device-flow helpers); wire CPM/slnx/packages.json; publish GPR status: completed

• id: io-github

content: Add Novolis.IO.GitHub (Octokit device auth + content/ mirror Pull + SaveCommitPush); unit tests; publish GPR status: completed

• id: booksmobile-app

content: Scaffold BooksMobile / .Desktop / .Android under novolis-apps; sign-in, catalog nav, markdown edit, Pull + Save/Commit/Push; exclude from release catalog status: completed

• id: scripts

content: Add deploy-booksmobile-android.ps1 and run-booksmobile-desktop.ps1 with adb/ANDROID_HOME gates status: completed

• id: smoke

content: OAuth smoke on Windows + USB Install to SM-F741B; Pull/edit/push against frankhaugen/books status: completed isProject: false

Locked decisions

flowchart LR
  subgraph hosts [Hosts]
    Bridge[BooksMobile.Desktop]
    And[BooksMobile.Android]
  end
  subgraph shared [BooksMobile shared]
    UI[MainView editor nav]
    Scm[Pull and SaveCommitPush]
  end
  subgraph pkgs [Packages]
    Mob[Novolis.Avalonia.Mobile]
    MobA[Mobile.Android]
    MobD[Mobile.Desktop]
    Gh[Novolis.IO.GitHub]
    Ms[Novolis.Markup.Manuscript]
    Md[Novolis.Avalonia.Markdown]
  end
  Bridge --> UI
  And --> UI
  UI --> Mob
  Bridge --> MobD
  And --> MobA
  Scm --> Gh
  UI --> Ms
  UI --> Md
  Gh -->|"OAuth token"| Api[GitHub API]
  Api --> Books[frankhaugen/books]
  MobA --> Keystore[Android Keystore prefs]
  MobD --> CredMan[Windows Credential Manager]
  Gh --> Mirror[AppData content mirror]

1. Platform framework — `Novolis.Avalonia.Mobile*`

Add under novolis-avalonia/src/ (override TFM only on Android; keep root Directory.Build.props at net10.0 for other packages):

Wire: csproj + CPM pins (Avalonia.Android 12.0.2, AndroidX.Browser as needed) in Directory.Packages.props, Novolis.Avalonia.slnx, .novolis/packages.json, package READMEs. Publish to GPR before apps consume.

Best-practice paths

• Android workspace: {FilesDir}/workspace/ (private app storage; survives update; cleared on uninstall)
• Windows workspace: %LocalAppData%\Novolis\BooksMobile\workspace\
• Token key: github.oauth.access_token in secure store only (never prefs plaintext / never files)

2. GitHub sync — `Novolis.IO.GitHub`

New packable project in novolis-io/src/Novolis.IO.GitHub/:

• Octokit client with injected token accessor
• GitHubDeviceAuth — device code request + poll (repo scope for private frankhaugen/books)
• BooksRepoMirror:
• Pull: resolve default branch → git tree under content/ → download blobs → write into local workspace root so `ManuscriptWorkspace.TryOpen` works
• SaveCommitPush: write dirty files → Git Data API (blobs → tree → commit → update ref) or Contents API multi-file update with base SHA; auto message; single user gesture
• Track local dirty set (in-memory + optional .novolis/mobile-dirty.json under workspace)
• Unit tests with mocked HTTP / Octokit fakes for tree + commit path

Do not call `GitRepositoryService` from the mobile app (no git on Android; keep desktop Studio on process git).

3. App — Avalonia xplat in `novolis-apps`

novolis-apps/src/BooksMobile/
  BooksMobile/                 # net10.0 shared: App, MainView, ViewModels, services
  BooksMobile.Desktop/         # WinExe + Avalonia.Desktop
  BooksMobile.Android/         # net10.0-android + Avalonia.Android + AvaloniaAndroidApplication

Shared UI (v0)

• Sign-in screen: start device flow → show user code → “Open GitHub” (launcher) → poll until token → store via ISecureTokenStore
• Nav: series → book → chapter (via Novolis.Markup.Manuscript)
• Editor: MarkdownSourceEditor from Novolis.Avalonia.Markdown (preview/Mermaid deferred if Android cost is high)
• Toolbar: Pull | Save/Commit/Push | Sign out
• Status line: branch, dirty count, last sync error

Bootstrap

• Desktop: classic lifetime + MainWindow hosting MainView (same pattern as BooksWriterStudio/Program.cs)
• Android: AvaloniaAndroidApplication<App> + AvaloniaMainActivity; ISingleViewApplicationLifetime / MainViewFactory
• Register AddNovolisMobileAndroid() / AddNovolisMobileDesktop() in each head

Exclusion from pipeline

• Do not add to Get-NovolisAppCatalog in Publish-NovolisApp.ps1
• Do not add to ValidateSet in build-installer.ps1
• Optional: mention in README as “local Android/Desktop — not released”

CPM: add Avalonia.Android, Octokit, Mobile package versions to novolis-apps/Directory.Packages.props.

4. OAuth app (one-time, outside code)

Create a GitHub OAuth App (account frankhaugen is fine):

• Name: Novolis BooksMobile
• Device flow enabled (no callback required for device grant)
• Client ID embedded as public config in app (GitHub:ClientId); no client secret in the app
• Scope requested: repo

Document Client ID setup in src/BooksMobile/README.md (how to set via appsettings / env BOOKSMOBILE_GITHUB_CLIENT_ID for local).

5. Local scripts (no CI install)

Under novolis-apps/scripts/:

Both scripts fail fast with clear text if GPR packages missing or adb unauthorized.

6. Implementation order

1. Novolis.Avalonia.Mobile (+ Android/Desktop) — secure store, paths, browser launcher, device-flow presenter helpers
2. Novolis.IO.GitHub — device auth + content mirror Pull / SaveCommitPush + tests
3. Publish both package lines to GitHub Packages (merge CI)
4. Scaffold BooksMobile xplat app + scripts; PackageReference only
5. Smoke: desktop run against OAuth; Android deploy-booksmobile-android.ps1 onto SM-F741B; Pull → edit chapter → Save/Commit/Push → verify on github.com/frankhaugen/books

Out of scope (explicit)

• Play Store / Inno / merge release catalog
• Full Novolis.IO.Git on device
• Audiobook/PDF publish, spellcheck, Mermaid-first preview
• Wireless adb as default
• iOS / browser heads