Files
Lumotia/docs/architecture-map/01-frontend/pages/first-run.md
Jake 26c7307607
Some checks failed
check / cargo check (macos-latest) (push) Has been cancelled
check / cargo check (ubuntu-22.04) (push) Has been cancelled
check / cargo check (windows-latest) (push) Has been cancelled
check / svelte build + lint (push) Has been cancelled
agent: lumotia-rebrand — docs, scripts, root config, residuals
Phase 9 of the rebrand cascade. Sweep covers everything the Phase 8
frontend pass deliberately skipped: docs/, root markdown, scripts,
Cargo.toml descriptions, code comments that survived earlier
word-boundary sed, plus a handful of identifiers caught on the final
verify pass.

transcription-app changes:
- README.md, HANDOVER.md, KNOWN-ISSUES.md, run.sh — magnotia/Magnotia
  -> lumotia/Lumotia.
- docs/ — sweep across all subdirs except docs/handovers/ (preserved
  as immutable audit trail). Includes architecture-map references
  to magnotia_core::*, magnotia_storage::*, etc. now pointing at
  lumotia_*; dev-setup.md tracing output examples (lumotia_startup
  target); brief/ + superpowers/ + issues/ + whisper-ecosystem/ +
  audit/.
- Cargo.toml descriptions on 9 crates (core, audio, cloud-providers,
  hotkey, llm, mcp, plus referenced others).
- crates/core/src/{error,hardware,recommendation,paths}.rs +
  crates/audio/src/wav.rs + crates/llm/src/model_manager.rs +
  crates/cloud-providers/src/keystore.rs + crates/mcp/src/lib.rs —
  doc comments and a model-manager user-agent string.
- Caught on final pass: BroadcastChannel("magnotia_task_sync") -> ...
  ("lumotia_task_sync"); magnotia_locale i18n localStorage key
  renamed + migration shim added; CSS keyframe names
  magnotiaPulse / magnotiaBar / magnotiaFade renamed in the design-
  system kit; magnotia_viewer_item / magnotia_viewer_mode handoff
  keys renamed in HistoryPage + viewer/+page.svelte; src/assets/
  wordmark.svg text.
- src-tauri/src/lib.rs comment cleanup ("magnotia era" was sed'd
  to "lumotia era" earlier — restored).

Preserved (intentional):
- crates/core/src/paths.rs — keeps "magnotia" / "Magnotia" / ".magnotia"
  legacy detection strings in legacy_and_target_paths() so the
  migration shim can still find user data from the magnotia era.
- src/lib/stores/{page,focusTimer}.svelte.ts + src/lib/i18n/index.ts
  — migration call sites reference the legacy magnotia keys
  deliberately.
- docs/handovers/ — historical audit trail.

cargo build --workspace passes. npm run check: 0 errors / 0 warnings
(3958 files). cargo test --workspace: 339 pass / 0 fail.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 12:38:03 +01:00

2.7 KiB

name, type, slice, last_verified
name type slice last_verified
First run page architecture-map-page 01-frontend 2026/05/09

First run page

Where you are: Architecture mapFrontendPages overview → First run

Plain English summary. What the user sees the first time they launch Lumotia, before any model is on disk. Probes hardware, recommends a Whisper model size, and downloads the chosen model (Whisper or Parakeet). On success, transitions to the dictation page.

At a glance

  • Path: src/lib/pages/FirstRunPage.svelte
  • LOC: 337
  • Imports:
    • Tauri: invoke, listen.
    • Stores: page, settings, saveSettings from page.svelte.ts. toasts.
    • Components: UnicodeSpinner.
    • External: lucide-svelte (Download, CheckCircle, Sunrise, Moon, Play).
  • Includes: also ShutdownRitualPage is imported here (suggesting the "evening ritual" preview lives in this same flow). Verify on read; treat as a coupled flow.

What's in here

Probe

  • onMount calls probe_system and rank_models (FirstRunPage.svelte:31-32) to compute recommended models given the user's RAM, GPU, OS.
  • Sets probing = false and renders the recommendation UI.

Download

  • downloadAndGo(modelId) (FirstRunPage.svelte:55-95):
    • Subscribes to model-download-progress and parakeet-download-progress events.
    • Calls download_model then load_model (Whisper) or download_parakeet_model then load_parakeet_model.
    • On success, sets ready = true and routes to dictation (page.current = "dictation").
    • Computes estimatedMinutes from elapsed and progress percent (derived.by).

Triggering

  • The shell auto sets page.current = "first-run" if list_models and list_parakeet_models are both empty (+layout.svelte:346-353).
  • Skip path: clicking "Get started" without a model lets the user opt out (still routes to dictation).

Tauri command surface

probe_system, rank_models, download_model, load_model, download_parakeet_model, load_parakeet_model. Events: model-download-progress, parakeet-download-progress.

Watch outs

  • The download is a single shot. There is no resume on cancel; if the user closes the app mid download, they restart from zero. Slice 02/05 may improve this later.
  • estimatedMinutes is a linear extrapolation. Network speed is not constant; expect the value to wiggle.
  • The page imports ShutdownRitualPage but the value of doing so should be confirmed (potential dead import).

See also