Jake
26c7307607
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>
60 lines
2.7 KiB
Markdown
60 lines
2.7 KiB
Markdown
---
|
|
name: First run page
|
|
type: architecture-map-page
|
|
slice: 01-frontend
|
|
last_verified: 2026/05/09
|
|
---
|
|
|
|
# First run page
|
|
|
|
> **Where you are:** [Architecture map](../../README.md) → [Frontend](../README.md) → [Pages overview](../pages-overview.md) → 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
|
|
|
|
- [Pages overview](../pages-overview.md). When this page is forced.
|
|
- [Frontend ↔ Tauri bridge](../frontend-tauri-bridge.md). Probe and download commands.
|
|
- [Windows and routes](../windows-and-routes.md). Shell triggers.
|