From 5932c0d3a1202b7fc0d4fd3c3b374e1ef2d22037 Mon Sep 17 00:00:00 2001
From: John Lancaster <32917998+jsl12@users.noreply.github.com>
Date: Mon, 3 Aug 2026 22:56:04 -0500
Subject: [PATCH] global theming

---
 src/transcription/api/health.py            | 10 +--
 src/transcription/app.py                   |  7 +-
 src/transcription/ui/__init__.py           | 33 ---------
 src/transcription/ui/pages/__init__.py     | 23 ++++++
 src/transcription/ui/pages/jobs_page.py    | 37 +++++-----
 src/transcription/ui/pages/people_page.py  | 82 +++++++++++++---------
 src/transcription/ui/pages/sources_page.py | 52 +++++++-------
 src/transcription/ui/theme.py              | 28 +++++---
 tests/test_main.py                         | 16 ++---
 tests/test_ui_theme.py                     |  2 +-
 10 files changed, 152 insertions(+), 138 deletions(-)

diff --git a/src/transcription/api/health.py b/src/transcription/api/health.py
index 2ee9fa5..961ca07 100644
--- a/src/transcription/api/health.py
+++ b/src/transcription/api/health.py
@@ -5,12 +5,12 @@ from fastapi import APIRouter
 router = APIRouter()
 
 
-def healthz() -> dict[str, str]:
-    """Return a simple health status payload."""
-    return {"status": "ok"}
-
-
 @router.get("/healthz")
 def healthz_route() -> dict[str, str]:
     """Route wrapper for health status payload."""
     return healthz()
+
+
+def healthz() -> dict[str, str]:
+    """Return a simple health status payload."""
+    return {"status": "ok"}
diff --git a/src/transcription/app.py b/src/transcription/app.py
index c6d29a8..d388bae 100644
--- a/src/transcription/app.py
+++ b/src/transcription/app.py
@@ -13,7 +13,6 @@ from fastapi import FastAPI
 from fastapi import status
 from fastapi.responses import RedirectResponse
 from fastapi.staticfiles import StaticFiles
-from nicegui import ui
 
 from .api.errors import register_error_handlers
 from .api.health import router as health_router
@@ -25,8 +24,7 @@ from .db import dispose_database_runtime
 from .db import initialize_database_runtime
 from .services import ServiceBundle
 from .services.jobs import JobService
-from .ui import register_pages
-from .ui.theme import THEME_COLORS
+from .ui.pages import register_pages
 from .worker import worker_consumer_lifespan
 
 logger = logging.getLogger(__name__)
@@ -98,8 +96,7 @@ def create_app(settings: Settings | None = None) -> FastAPI:
     def health() -> dict[str, str]:
         return {"status": "ok"}
 
+    app.include_router(health_router)
     register_error_handlers(app)
     register_pages(app)
-    app.include_router(health_router)
-    ui.colors(**THEME_COLORS)
     return app
diff --git a/src/transcription/ui/__init__.py b/src/transcription/ui/__init__.py
index 51cfaca..e69de29 100644
--- a/src/transcription/ui/__init__.py
+++ b/src/transcription/ui/__init__.py
@@ -1,33 +0,0 @@
-"""UI page registration exports."""
-
-from fastapi import FastAPI
-from nicegui import ui
-
-from transcription.ui.pages.documents import register_pages as register_documents_pages
-from transcription.ui.pages.jobs_page import register_page as register_jobs_page
-from transcription.ui.pages.people_page import register_page as register_people_page
-from transcription.ui.pages.sources_page import register_page as register_sources_page
-from transcription.ui.pages.upload_page import register_page as register_upload_page
-from transcription.ui.resources import read_css
-
-_THEME_REGISTERED_STATE_KEY = "transcription_ui_theme_registered"
-
-
-def _register_global_styles(app: FastAPI) -> None:
-    if getattr(app.state, _THEME_REGISTERED_STATE_KEY, False):
-        return
-
-    ui.add_css(read_css("theme.css"), shared=True)
-
-    setattr(app.state, _THEME_REGISTERED_STATE_KEY, True)
-
-
-def register_pages(app: FastAPI) -> None:
-    """Register all NiceGUI pages and mount them onto the FastAPI app."""
-    _register_global_styles(app)
-    register_upload_page()
-    register_documents_pages()
-    register_people_page()
-    register_sources_page()
-    register_jobs_page()
-    ui.run_with(app, mount_path="/ui", show_welcome_message=False, dark=False)
diff --git a/src/transcription/ui/pages/__init__.py b/src/transcription/ui/pages/__init__.py
index e69de29..83b06cf 100644
--- a/src/transcription/ui/pages/__init__.py
+++ b/src/transcription/ui/pages/__init__.py
@@ -0,0 +1,23 @@
+from fastapi import FastAPI
+from nicegui import ui
+
+from transcription.ui.pages.documents import register_pages as register_documents_pages
+
+from ..theme import register_global_styles
+from .jobs_page import register_page as register_jobs_page
+from .people_page import register_page as register_people_page
+from .sources_page import register_page as register_sources_page
+from .upload_page import register_page as register_upload_page
+
+__all__ = ["register_pages"]
+
+
+def register_pages(app: FastAPI) -> None:
+    """Register all NiceGUI pages and mount them onto the FastAPI app."""
+    register_global_styles(app)
+    register_upload_page()
+    register_documents_pages()
+    register_people_page()
+    register_sources_page()
+    register_jobs_page()
+    ui.run_with(app, mount_path="/ui", show_welcome_message=False, dark=False)
diff --git a/src/transcription/ui/pages/jobs_page.py b/src/transcription/ui/pages/jobs_page.py
index 242f248..8136952 100644
--- a/src/transcription/ui/pages/jobs_page.py
+++ b/src/transcription/ui/pages/jobs_page.py
@@ -23,7 +23,6 @@ from transcription.ui.components.primitives import destructive_button
 from transcription.ui.components.primitives import render_empty_state
 from transcription.ui.components.primitives import section_header_row
 from transcription.ui.components.table.jobs import render_jobs_table
-from transcription.ui.theme import apply_archival_theme
 from transcription.ui.theme import page_header
 from transcription.worker import resolve_worker_notifier
 
@@ -36,7 +35,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/jobs")
     async def jobs_page(session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         jobs_service = JobService(session_factory=session_factory)
         render_navigation_header(current_path="/jobs")
 
@@ -68,12 +67,14 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/jobs/new")
     async def job_create_page(request: Request, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         documents_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/jobs")
 
         with ui.column().classes("w-full max-w-4xl mx-auto p-4 gap-4"):
-            page_header("Create Processing Job", subtitle="Queue source files for AI transcription and entity processing.")
+            page_header(
+                "Create Processing Job", subtitle="Queue source files for AI transcription and entity processing."
+            )
 
             documents = await documents_service.list_documents()
             if not documents:
@@ -88,7 +89,9 @@ def register_page() -> None:  # noqa: PLR0915
                             on_click=lambda: ui.navigate.to("/documents/new?return_to=jobs_new"),
                             icon="note_add",
                         ).classes("ui-btn-primary")
-                        ui.button("Back to Jobs", on_click=lambda: ui.navigate.to("/jobs"), icon="arrow_back").props("flat")
+                        ui.button("Back to Jobs", on_click=lambda: ui.navigate.to("/jobs"), icon="arrow_back").props(
+                            "flat"
+                        )
                 return
 
             uploaded_files: list[tuple[str, bytes]] = []
@@ -136,18 +139,16 @@ def register_page() -> None:  # noqa: PLR0915
 
                     with ui.column().classes("gap-1 w-full mt-2"):
                         for index, (filename, _) in ordered_uploads:
-                            with ui.row().classes(
-                                "w-full items-center justify-between ui-row-surface p-2"
-                            ):
+                            with ui.row().classes("w-full items-center justify-between ui-row-surface p-2"):
                                 ui.label(Path(filename).name).classes("text-xs font-mono ui-text-primary")
                                 ui.button(icon="delete", on_click=lambda idx=index: remove_file(idx)).props(
                                     "flat round dense color=negative text-xs"
                                 )
 
                         with ui.row().classes("w-full justify-end mt-2"):
-                            ui.button("Clear files", on_click=clear_files, icon="clear_all").props("flat dense").classes(
-                                "text-xs text-red-800"
-                            )
+                            ui.button("Clear files", on_click=clear_files, icon="clear_all").props(
+                                "flat dense"
+                            ).classes("text-xs text-red-800")
 
                 async def on_upload(event) -> None:
                     payload = await event.file.read()
@@ -204,7 +205,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/jobs/{job_id}")
     async def job_detail_page(job_id: str, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         jobs_service = JobService(session_factory=session_factory)
         render_navigation_header(current_path="/jobs")
 
@@ -256,7 +257,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/jobs/{job_id}/delete")
     async def job_delete_page(job_id: str, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         jobs_service = JobService(session_factory=session_factory)
         render_navigation_header(current_path="/jobs")
 
@@ -282,7 +283,9 @@ def register_page() -> None:  # noqa: PLR0915
                     ui.label("Delete is blocked while the job is processing.").classes(
                         "text-xs text-red-800 font-bold mt-2"
                     )
-                    ui.label("Wait for processing to complete, then retry delete.").classes("text-xs ui-text-muted italic")
+                    ui.label("Wait for processing to complete, then retry delete.").classes(
+                        "text-xs ui-text-muted italic"
+                    )
                     with ui.row().classes("w-full items-center gap-2 mt-4"):
                         ui.button(
                             "Back to Job",
@@ -296,7 +299,9 @@ def register_page() -> None:  # noqa: PLR0915
 
                 ui.label("This action permanently deletes the job.").classes("text-xs text-red-800 font-medium")
                 if job.job_sources:
-                    ui.label("Related JobSource links will be removed as part of delete.").classes("text-xs ui-text-muted")
+                    ui.label("Related JobSource links will be removed as part of delete.").classes(
+                        "text-xs ui-text-muted"
+                    )
 
             async def submit_delete() -> None:
                 try:
@@ -322,4 +327,4 @@ def register_page() -> None:  # noqa: PLR0915
                     icon="delete_forever",
                     variant="solid",
                 )
-                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/jobs/{job.id}"), icon="arrow_back").props("flat")
\ No newline at end of file
+                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/jobs/{job.id}"), icon="arrow_back").props("flat")
diff --git a/src/transcription/ui/pages/people_page.py b/src/transcription/ui/pages/people_page.py
index c193f3e..023ec31 100644
--- a/src/transcription/ui/pages/people_page.py
+++ b/src/transcription/ui/pages/people_page.py
@@ -9,15 +9,15 @@ from uuid import UUID
 from fastapi import Request
 from nicegui import ui
 
-from transcription.config import Settings, get_settings
+from transcription.config import Settings
+from transcription.config import get_settings
 from transcription.db.models import Person
 from transcription.errors import ErrorCategory
-from transcription.services.documents import (
-    DocumentError,
-    DocumentService,
-    PersonDeleteBlockedError,
-)
-from transcription.services.store import UploadError, store_person_portrait
+from transcription.services.documents import DocumentError
+from transcription.services.documents import DocumentService
+from transcription.services.documents import PersonDeleteBlockedError
+from transcription.services.store import UploadError
+from transcription.services.store import store_person_portrait
 from transcription.ui.components.app_shell import render_navigation_header
 from transcription.ui.components.cards import archival_card
 from transcription.ui.components.data_display import metadata_row
@@ -25,9 +25,9 @@ from transcription.ui.components.error_presenter import show_error
 from transcription.ui.components.primitives import destructive_button
 from transcription.ui.components.primitives import render_empty_state
 from transcription.ui.components.primitives import section_header_row
-from transcription.ui.components.table.people import PersonTableRow, render_people_table
+from transcription.ui.components.table.people import PersonTableRow
+from transcription.ui.components.table.people import render_people_table
 from transcription.ui.components.viewers import dark_room_viewer
-from transcription.ui.theme import apply_archival_theme
 from transcription.ui.theme import page_header
 
 from ...db.session import SessionFactoryDep
@@ -104,7 +104,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/people")
     async def people_page(session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         people_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/people")
 
@@ -142,7 +142,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/people/new")
     async def person_create_page(request: Request, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         people_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/people")
 
@@ -211,7 +211,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/people/{person_id}")
     async def person_detail_page(person_id: str, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         people_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/people")
 
@@ -271,9 +271,7 @@ def register_page() -> None:  # noqa: PLR0915
 
                 with ui.column().classes("col-span-12 lg:col-span-4 gap-4"):
                     with archival_card(title="Biography"):
-                        ui.label(person.biography or "No biography recorded.").classes(
-                            "p-2 ui-note-box text-xs w-full"
-                        )
+                        ui.label(person.biography or "No biography recorded.").classes("p-2 ui-note-box text-xs w-full")
 
                     with archival_card(title="Linked Documents"):
                         if not person.document_people:
@@ -285,9 +283,7 @@ def register_page() -> None:  # noqa: PLR0915
                                     document = link.document
                                     if document is None:
                                         continue
-                                    with ui.row().classes(
-                                        "w-full justify-between items-center ui-row-surface p-2"
-                                    ):
+                                    with ui.row().classes("w-full justify-between items-center ui-row-surface p-2"):
                                         with ui.column().classes("gap-0"):
                                             ui.label(document.name).classes("text-xs font-semibold ui-text-primary")
                                             ui.label(f"Role: {link.role.value}").classes("text-[10px] ui-text-muted")
@@ -301,7 +297,7 @@ def register_page() -> None:  # noqa: PLR0915
 
     @ui.page("/people/{person_id}/edit")
     async def person_edit_page(person_id: str, request: Request, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         people_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/people")
 
@@ -329,7 +325,9 @@ def register_page() -> None:  # noqa: PLR0915
                     display_name_input = ui.input(label="Display name", value=person.display_name or "").props(
                         "outlined bg-white"
                     )
-                    maiden_name_input = ui.input(label="Maiden name", value=person.maiden_name or "").props("outlined bg-white")
+                    maiden_name_input = ui.input(label="Maiden name", value=person.maiden_name or "").props(
+                        "outlined bg-white"
+                    )
 
                 with ui.row().classes("w-full gap-3 grid grid-cols-1 md:grid-cols-3"):
                     birth_date_input = ui.input(
@@ -339,7 +337,9 @@ def register_page() -> None:  # noqa: PLR0915
                     birth_date_raw_input = ui.input(
                         label="Birth date (approximate)", value=person.birth_date_raw or ""
                     ).props("outlined bg-white")
-                    birth_place_input = ui.input(label="Birth place", value=person.birth_place or "").props("outlined bg-white")
+                    birth_place_input = ui.input(label="Birth place", value=person.birth_place or "").props(
+                        "outlined bg-white"
+                    )
 
                 with ui.row().classes("w-full gap-3 grid grid-cols-1 md:grid-cols-3"):
                     death_date_input = ui.input(
@@ -349,13 +349,19 @@ def register_page() -> None:  # noqa: PLR0915
                     death_date_raw_input = ui.input(
                         label="Death date (approximate)", value=person.death_date_raw or ""
                     ).props("outlined bg-white")
-                    death_place_input = ui.input(label="Death place", value=person.death_place or "").props("outlined bg-white")
+                    death_place_input = ui.input(label="Death place", value=person.death_place or "").props(
+                        "outlined bg-white"
+                    )
 
                 biography_input = (
-                    ui.textarea(label="Biography", value=person.biography or "").props("outlined bg-white autogrow").classes("w-full")
+                    ui.textarea(label="Biography", value=person.biography or "")
+                    .props("outlined bg-white autogrow")
+                    .classes("w-full")
                 )
                 portrait_path_input = (
-                    ui.input(label="Portrait path", value=person.portrait_path or "").props("outlined bg-white").classes("w-full")
+                    ui.input(label="Portrait path", value=person.portrait_path or "")
+                    .props("outlined bg-white")
+                    .classes("w-full")
                 )
                 _bind_portrait_file_picker(portrait_path_input, settings=_resolve_runtime_settings(request))
 
@@ -401,11 +407,13 @@ def register_page() -> None:  # noqa: PLR0915
 
             with ui.row().classes("w-full items-center gap-2 mt-2"):
                 ui.button("Save changes", on_click=submit_edit, icon="save").classes("ui-btn-primary")
-                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/people/{person.id}"), icon="arrow_back").props("flat")
+                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/people/{person.id}"), icon="arrow_back").props(
+                    "flat"
+                )
 
     @ui.page("/people/{person_id}/delete")
     async def person_delete_page(person_id: str, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         people_service = DocumentService(session_factory=session_factory)
         render_navigation_header(current_path="/people")
 
@@ -431,21 +439,27 @@ def register_page() -> None:  # noqa: PLR0915
                 ui.label(f"Person: {person.full_name}").classes("text-sm font-semibold ui-text-primary")
 
                 if person.document_people:
-                    ui.label("Delete is blocked because linked documents exist.").classes("text-xs text-red-800 font-bold mt-2")
+                    ui.label("Delete is blocked because linked documents exist.").classes(
+                        "text-xs text-red-800 font-bold mt-2"
+                    )
                     ui.label(f"Linked documents: {len(person.document_people)}").classes("text-xs ui-text-muted")
-                    ui.label("Remove document links first, then retry deletion.").classes("text-xs ui-text-muted italic")
+                    ui.label("Remove document links first, then retry deletion.").classes(
+                        "text-xs ui-text-muted italic"
+                    )
                     with ui.row().classes("w-full items-center gap-2 mt-4"):
                         ui.button(
                             "Back to Person",
                             on_click=lambda: ui.navigate.to(f"/people/{person.id}"),
                             icon="arrow_back",
                         ).classes("ui-btn-primary text-xs")
-                        ui.button("Go to Documents", on_click=lambda: ui.navigate.to("/documents"), icon="description").props(
-                            "flat text-xs"
-                        )
+                        ui.button(
+                            "Go to Documents", on_click=lambda: ui.navigate.to("/documents"), icon="description"
+                        ).props("flat text-xs")
                     return
 
-                ui.label("This action permanently deletes the person record.").classes("text-xs text-red-800 font-medium")
+                ui.label("This action permanently deletes the person record.").classes(
+                    "text-xs text-red-800 font-medium"
+                )
 
             async def submit_delete() -> None:
                 try:
@@ -475,4 +489,6 @@ def register_page() -> None:  # noqa: PLR0915
                     icon="delete_forever",
                     variant="solid",
                 )
-                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/people/{person.id}"), icon="arrow_back").props("flat")
\ No newline at end of file
+                ui.button("Cancel", on_click=lambda: ui.navigate.to(f"/people/{person.id}"), icon="arrow_back").props(
+                    "flat"
+                )
diff --git a/src/transcription/ui/pages/sources_page.py b/src/transcription/ui/pages/sources_page.py
index a9b1141..722c45e 100644
--- a/src/transcription/ui/pages/sources_page.py
+++ b/src/transcription/ui/pages/sources_page.py
@@ -9,21 +9,20 @@ from fastapi import Request
 from fastapi.responses import RedirectResponse
 from nicegui import ui
 
-from transcription.db.models import JobSource, Source
-from transcription.services.documents import DocumentError, DocumentService
+from transcription.db.models import Source
+from transcription.services.documents import DocumentError
+from transcription.services.documents import DocumentService
 from transcription.services.jobs import JobService
-from transcription.services.transcription import (
-    TranscriptionNotFoundError,
-    TranscriptionService,
-)
+from transcription.services.transcription import TranscriptionNotFoundError
+from transcription.services.transcription import TranscriptionService
 from transcription.ui.components.app_shell import render_navigation_header
 from transcription.ui.components.cards import archival_card
 from transcription.ui.components.data_display import metadata_row
 from transcription.ui.components.document_panzoom import render_document_panzoom
 from transcription.ui.components.error_presenter import show_error
 from transcription.ui.components.primitives import section_header_row
-from transcription.ui.components.table.sources import SourceTableRow, render_sources_table
-from transcription.ui.theme import apply_archival_theme
+from transcription.ui.components.table.sources import SourceTableRow
+from transcription.ui.components.table.sources import render_sources_table
 from transcription.ui.theme import page_header
 
 from ...db.session import SessionFactoryDep
@@ -34,7 +33,7 @@ def register_page() -> None:
 
     @ui.page("/sources")
     async def sources_page(request: Request, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
+
         sources_service = TranscriptionService(session_factory=session_factory)
         jobs_service = JobService(session_factory=session_factory)
         documents_service = DocumentService(session_factory=session_factory)
@@ -56,7 +55,7 @@ def register_page() -> None:
                 document = await documents_service.read_document_detail(document_id=document_id)
                 document_name = document.name
                 back_path = f"/documents/{document.id}"
-                sources = list(sorted(document.sources, key=lambda item: (item.page_number, item.upload_name.casefold())))
+                sources = sorted(document.sources, key=lambda item: (item.page_number, item.upload_name.casefold()))
             elif job_id is not None:
                 job = await jobs_service.read_job(job_id=job_id)
                 job_label = str(job.id)
@@ -65,7 +64,9 @@ def register_page() -> None:
                 sources = [job_source.source for job_source in job_sources if job_source.source is not None]
                 sources.sort(key=lambda item: (item.page_number, item.upload_name.casefold()))
             else:
-                sources = list(sorted(await sources_service.list_sources(), key=lambda item: (item.document_id, item.page_number)))
+                sources = sorted(
+                    await sources_service.list_sources(), key=lambda item: (item.document_id, item.page_number)
+                )
         except DocumentError:
             ui.label("Document not found").classes("text-h6 text-red-800 p-4")
             return
@@ -89,9 +90,9 @@ def register_page() -> None:
 
                 if back_path is not None:
                     back_label = "Back to Document" if document_id is not None else "Back to Job"
-                    ui.button(back_label, on_click=lambda route=back_path: ui.navigate.to(route), icon="arrow_back").classes(
-                        "ui-btn-primary text-xs"
-                    )
+                    ui.button(
+                        back_label, on_click=lambda route=back_path: ui.navigate.to(route), icon="arrow_back"
+                    ).classes("ui-btn-primary text-xs")
 
             # Format source records into read-model rows for the table renderer
             rows = [
@@ -108,7 +109,6 @@ def register_page() -> None:
 
     @ui.page("/sources/{source_id}")
     async def source_detail_page(source_id: str, request: Request, session_factory: SessionFactoryDep) -> None:
-        apply_archival_theme()
         sources_service = TranscriptionService(session_factory=session_factory)
         render_navigation_header(current_path="/sources")
 
@@ -131,7 +131,9 @@ def register_page() -> None:
 
         with ui.column().classes("w-full max-w-[1800px] mx-auto p-4 gap-4"):
             with section_header_row():
-                page_header(f"Source Page {source.page_number}: {source.upload_name}", subtitle=f"Source ID: {source.id}")
+                page_header(
+                    f"Source Page {source.page_number}: {source.upload_name}", subtitle=f"Source ID: {source.id}"
+                )
 
                 if back_path is not None:
                     back_label = (
@@ -141,9 +143,9 @@ def register_page() -> None:
                         if "job_id" in request.query_params
                         else "Back to Sources"
                     )
-                    ui.button(back_label, on_click=lambda route=back_path: ui.navigate.to(route), icon="arrow_back").classes(
-                        "ui-btn-primary text-xs"
-                    )
+                    ui.button(
+                        back_label, on_click=lambda route=back_path: ui.navigate.to(route), icon="arrow_back"
+                    ).classes("ui-btn-primary text-xs")
                 else:
                     ui.button("Back to Sources", on_click=lambda: ui.navigate.to("/sources"), icon="arrow_back").props(
                         "flat text-xs"
@@ -167,9 +169,9 @@ def register_page() -> None:
                         )
 
                     with archival_card(title="Automated Raw Transcription"):
-                        ui.textarea(value=_source_transcription_text(source) or "").props("outlined autogrow readonly bg-white").classes(
-                            "w-full text-xs font-mono"
-                        )
+                        ui.textarea(value=_source_transcription_text(source) or "").props(
+                            "outlined autogrow readonly bg-white"
+                        ).classes("w-full text-xs font-mono")
 
                     with archival_card(title="Curated Human Transcription"):
                         revision_input = (
@@ -194,7 +196,9 @@ def register_page() -> None:
                             ui.navigate.to(request.url.path + _back_query(request.query_params))
 
                         with ui.row().classes("w-full items-center gap-2 mt-2"):
-                            ui.button("Save Revision", on_click=save_revision, icon="save").classes("ui-btn-primary text-xs")
+                            ui.button("Save Revision", on_click=save_revision, icon="save").classes(
+                                "ui-btn-primary text-xs"
+                            )
 
     @ui.page("/documents/{document_id}/sources")
     async def document_sources_page(document_id: str) -> RedirectResponse:
@@ -252,4 +256,4 @@ def _source_transcription_text(source: Source) -> str | None:
     for job_source in sorted(source.job_sources, key=lambda item: item.executed_at, reverse=True):
         if job_source.error_detail:
             return job_source.error_detail
-    return None
\ No newline at end of file
+    return None
diff --git a/src/transcription/ui/theme.py b/src/transcription/ui/theme.py
index dc7bc92..7443bd2 100644
--- a/src/transcription/ui/theme.py
+++ b/src/transcription/ui/theme.py
@@ -1,5 +1,12 @@
+from fastapi import FastAPI
+from nicegui import app as nicegui_app
 from nicegui import ui
 
+from .resources import read_css
+
+_THEME_REGISTERED_STATE_KEY = "transcription_ui_theme_registered"
+
+
 # Runtime bridge for Quasar color slots. Visual ownership remains in theme.css tokens/classes.
 THEME_COLORS = {
     "primary": "#5e6572",
@@ -12,17 +19,20 @@ THEME_COLORS = {
     "warning": "#a9b4c2",
 }
 
-_THEME_APPLIED = False
 
-
-def apply_archival_theme() -> None:
-    """Apply runtime color slots once; visual styling is defined in theme.css."""
-    global _THEME_APPLIED
-    if _THEME_APPLIED:
+def register_global_styles(app: FastAPI) -> None:
+    if getattr(app.state, _THEME_REGISTERED_STATE_KEY, False):
         return
 
-    ui.colors(**THEME_COLORS)
-    _THEME_APPLIED = True
+    theme_css = read_css("theme.css")
+    try:
+        ui.add_css(theme_css, shared=True)
+    except RuntimeError:
+        # NiceGUI can retain stale slot state across test app factories.
+        ui.add_head_html(f"<style>{theme_css}</style>", shared=True)
+
+    setattr(app.state, _THEME_REGISTERED_STATE_KEY, True)
+    nicegui_app.colors(**THEME_COLORS)
 
 
 def page_header(title: str, subtitle: str | None = None) -> None:
@@ -37,4 +47,4 @@ def page_header(title: str, subtitle: str | None = None) -> None:
 VIBESCRIBE_LOGO_SVG = """
 <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 1024 1024"><path fill="var(--palette-carbon-black)" d="M928.42 178.194C949.35 175.817 972.673 185.823 984.211 203.666C1007.4 239.295 980.694 284.53 960.921 315.685C934.399 357.475 899.805 396.065 867.301 433.343C843.968 460.19 820.437 486.864 796.709 513.363C769.456 543.226 741.022 572.208 713.803 602.179C707.24 609.405 708.08 610.486 704.27 619.169C700.982 626.664 693.822 634.696 686.897 639.06C675.182 646.442 662.535 647.487 649.275 644.782L542.197 748.449C535.408 755.006 467.755 819.273 462.281 821.292C454.993 823.981 442.674 821.682 434.676 821.543C431.265 830.087 404.146 905.202 402.549 906.237C401.68 906.8 390.045 906.949 388.081 907.198C374.994 908.863 362.056 911.982 349.366 915.527C306.041 927.341 264.461 944.81 225.699 967.485C216.893 972.73 198.799 988.768 189.292 988.241C187.043 988.117 184.973 987.361 183.531 985.568C177.167 977.658 187.716 970.087 191.936 964.387C196.099 958.764 199.492 949.831 202.684 943.422C216.521 915.64 227.617 885.572 232.36 854.782C233.504 847.353 233.549 839.791 234.563 832.339L315.489 778.818C327.32 770.862 342.046 761.504 353.338 753.115C354.073 747.86 355.286 737.244 358.485 733.283C397.725 684.684 439.383 637.652 481.224 591.255C499.661 570.81 517.219 549.921 536.443 530.178C531.774 517.144 530.815 504.767 539.31 492.866C548.138 480.5 559.119 477.255 573.392 474.786C579.887 468.713 588.59 458.709 594.87 451.974C605.438 440.714 616.146 429.586 626.992 418.593C668.276 376.398 710.784 335.418 754.463 295.708C792.781 260.867 876.543 184.248 928.42 178.194Z"/><path fill="var(--palette-cool-steel)" d="M847.805 244.719L848.444 244.715C873.382 244.719 891.198 254.802 908.439 272.132C890.135 294.42 870.307 315.703 851.032 337.165C802.823 390.847 751.925 442.155 703.626 495.705C699.568 491.347 695.61 487.001 691.111 483.099C669.588 464.518 644.353 455.311 616.075 453.891C626.985 441.197 641.143 427.847 653.069 415.696C687.873 380.435 723.67 346.169 760.418 312.939C777.775 297.171 794.955 281.392 812.996 266.407C821.232 259.567 829.969 251.527 838.662 245.439L847.805 244.719Z"/><path fill="white" d="M379.553 749.086C394.361 747.969 420.192 762.603 430.383 773.04C433.066 775.788 435.918 779.532 438.253 782.651C436.379 788.822 432.589 796.237 429.777 802.24C425.922 810.397 422.231 818.63 418.706 826.934C409.777 848.115 402.54 869.867 393.774 890.95C352.269 892.557 281.411 920.995 245.85 942.787C234.56 949.706 223.083 959.474 211.977 966.828L208.891 962.871C219.052 952.322 230.156 943.01 240.452 932.749C255.188 918.065 269.623 903.219 284.419 888.566C292.324 880.782 300.121 872.889 307.808 864.889C312.866 859.622 319.614 852.168 324.99 847.554L326.622 847.689C337.485 848.477 358.843 844.384 351.121 829.74C343.025 814.385 301.757 822.848 320.368 845.382C288.625 876.065 258.402 909.429 226.582 940.184C220.258 946.296 212.269 955.447 205.296 960.7C204.443 961.343 202.95 961.288 201.863 960.912C202.224 958.635 208.663 948.875 210.253 945.953C228.205 912.982 240.479 875.16 242.201 837.617C250.561 832.222 258.668 826.379 266.979 820.886C293.22 803.393 319.711 786.276 346.443 769.543C355.793 763.737 370.509 753.423 379.553 749.086Z"/><path fill="var(--palette-carbon-black)" d="M431.376 779.332L431.781 779.716C432.402 785.921 393.084 866.844 387.694 878.67C386.517 881.254 384.346 881.974 381.589 882.182C379.735 878.361 382.641 871.038 384.448 867.39C397.198 841.654 410.885 816.233 424.465 790.915C426.549 787.03 428.864 782.952 431.376 779.332Z"/><path fill="var(--palette-carbon-black)" d="M421.314 781.492L421.656 781.742L385.882 851.277C381.147 860.27 376.476 869.62 371.407 878.424C369.293 882.096 367.305 884.242 363.286 885.711C362.856 884.797 362.44 884.288 362.504 883.253C363.054 874.377 405.725 802.31 413.072 791.332C415.509 787.689 417.967 784.345 421.314 781.492Z"/><path fill="var(--palette-cool-steel)" d="M563.283 525.607C567.914 525.482 573.07 525.271 577.666 525.47C599.669 526.485 620.36 536.229 635.159 552.543C631.439 557.498 623.364 565.437 618.846 570.081C611.04 578.079 603.36 586.198 595.806 594.435L490.204 707.67L485.207 713.116C474.749 700.37 456.084 688.369 440.394 683.229C434.774 681.388 428.83 680.521 422.985 679.696C427.705 673.8 434.802 666.728 439.904 660.913C453.578 645.327 468.223 630.206 482.001 614.781L532.309 558.621C541.645 548.285 553.232 534.773 563.283 525.607Z"/><path fill="white" d="M413.959 688.903C422.503 689.358 429.399 690.082 437.48 693.105C468.305 704.637 498.418 733.266 498.899 767.881C494.978 771.623 489.885 775.922 485.762 779.626L484.896 780.146C483.765 778.612 482.801 769.317 481.733 765.813C478.707 756.396 473.919 745.12 467.33 737.605C449.401 717.155 427.34 706.457 400.763 703.816C405.165 698.28 408.919 693.835 413.959 688.903Z"/><path fill="var(--palette-cool-steel)" d="M928.825 193.157C940.778 191.941 951.228 195.497 961.449 201.497C990.603 218.611 975.286 263.003 961.648 284.81C959.766 279.771 958.492 275.492 957.01 270.362C967.206 257.306 974.761 246.361 973.224 228.959C970.607 218.288 964.313 206.914 951.544 206.069C947.32 205.79 950.485 215.455 949.498 218.846C947.144 226.931 942.55 233.469 937.438 240.083C924.506 227.826 904.045 214.233 886.155 212.209C898.576 203.534 913.721 195.584 928.825 193.157Z"/><path fill="var(--palette-cool-steel)" d="M925.851 328.498C926.283 329.579 926.614 330.839 926.512 332.026C925.581 342.887 828.697 453.184 815.993 467.484C805.056 479.796 793.566 491.611 782.629 503.936C771.415 516.697 760.116 529.383 748.732 541.993C746.108 544.889 737.797 554.535 735.3 556.753L734.578 556.349L731.989 544.196C746.892 526.086 767.14 509.733 782.927 492.007C801.094 471.61 820.284 451.953 838.477 431.581C853.574 414.676 867.975 397.092 882.668 379.837C897.513 362.82 911.864 346.244 925.851 328.498Z"/><path fill="var(--palette-cool-steel)" d="M662.356 598.894C662.678 602.375 662.27 604.597 661.825 608.056C655.563 616.029 644.405 626.416 637.151 634.134C603.986 669.42 567.8 701.833 533.552 736.029C525.91 743.659 517.849 751.091 509.762 758.253L508.87 757.529C508.114 753.943 507.113 750.204 506.212 746.633C518.497 733.737 535.786 718.688 549.021 706.04L662.356 598.894Z"/><path fill="white" d="M611.827 464.681C614.59 464.176 620.603 464.313 623.505 464.596C654.718 467.644 677.854 485.052 697.487 507.877C692.765 513.689 688.747 518.399 683.332 523.655C682.189 523.505 672.924 513.092 670.895 511.218C649.742 491.686 625.371 480.423 596.965 475.121C599.743 471.98 602.495 468.816 605.22 465.629L611.827 464.681Z"/><path fill="var(--palette-cool-steel)" d="M919.775 289.381C920.573 290.813 921.473 293.793 922.045 295.463C913.12 306.102 904.268 315.336 895.313 325.652C874.352 350.265 853.072 374.605 831.48 398.665C812.861 419.313 794.117 438.9 775.471 459.239L737.042 501.209C733.83 504.653 724.953 514.796 721.756 517.27L718.158 511.671C737.159 489.782 758.195 467.958 777.981 446.734C798.598 424.518 819.041 402.141 839.308 379.606L893.437 319.289C901.662 309.984 911.348 297.989 919.775 289.381Z"/><path fill="white" d="M392.475 712.511L393.141 712.49C429.952 711.508 469.871 741.851 475.304 779.035C475.797 782.404 475.86 785.861 475.923 789.262C472.659 792.805 467.489 797.405 463.767 800.412C463.359 800.731 463.646 800.57 462.805 800.627C462.063 798.163 462.818 794.85 462.639 792.161C460.983 767.332 442.689 747.449 421.964 735.66C411.791 729.872 393.671 722.422 381.876 725.742L392.475 712.511Z"/><path fill="var(--palette-cool-steel)" d="M924.84 311.864C926.039 313.07 926.808 313.58 926.748 315.259C923.297 320.902 912.438 332.165 907.43 337.841L873.026 377.342C834.456 421.47 797.38 464.971 756.776 507.585C750.957 513.669 745.228 519.839 739.592 526.093C736.887 529.119 732.738 534.269 729.933 536.875C728.7 534.536 727.268 531.078 726.156 528.582C734.806 518.326 751.138 502.705 760.884 492.737C779.954 473.096 798.774 453.215 817.339 433.096C841.296 406.65 865.036 380.008 888.556 353.173C901.025 338.937 911.276 325.771 924.84 311.864Z"/><path fill="var(--palette-cool-steel)" d="M648.368 565.327C649.711 566.263 651.217 567.994 652.379 569.219C640.561 582.419 624.705 597.736 612.157 611.012C574.715 650.73 536.902 690.096 498.723 729.105L498.252 729.213C496.843 728.208 495.944 726.213 495.055 724.65C500.568 717.468 509.329 709.481 515.704 702.789C559.566 656.747 603.557 610.424 648.368 565.327Z"/><path fill="var(--palette-cool-steel)" d="M576.787 492.21C589.808 490.947 611.805 497.983 623.489 503.629C651.637 517.534 674.913 539.455 685.723 569.75C693.088 590.391 695.278 624.365 668.99 633.332C666.934 634.034 665.739 634.374 663.78 633.362C663.159 631.717 663.373 632.154 663.661 630.184C665.515 628.481 669.727 628.259 671.963 627.092C679.007 623.416 682.436 616.793 685.211 609.983C697.611 558.593 625.745 490.675 574.944 498.819C559.917 501.228 556.349 509.111 548.13 519.993C548.026 519.099 547.928 518.203 547.836 517.308C545.933 498.576 561.546 493.35 576.787 492.21Z"/><path fill="white" d="M869.631 222.062C890.605 220.426 914.821 233.008 928.517 248.383C926.153 251.355 920.23 260.685 917.317 261.314L916.18 260.349C897.891 241.984 879.88 233.918 854.537 231.425C858.716 227.885 864.473 223.955 869.631 222.062Z"/><path fill="white" d="M704.438 519.878C714.614 527.761 724.985 560.535 717.701 572.83C716.411 575.008 714.392 579.022 711.849 579.908L711.43 578.764C707.644 561.37 701.696 548.463 692.181 533.706C696.193 529.031 700.279 524.421 704.438 519.878Z"/><path fill="var(--palette-cool-steel)" d="M659.42 584.786C659.68 584.915 660.382 585.489 660.644 585.691C661.779 588.314 662.332 589.943 660.02 592.2C654.948 597.15 649.494 601.713 644.266 606.504L614.898 633.958L562.536 682.194C543.158 699.746 524.499 716.104 505.344 734.24L504.491 734.804C504.761 731.77 558.728 681.688 565.366 675.392L659.42 584.786Z"/><path fill="var(--palette-cool-steel)" d="M386.543 733.189C392.595 732.332 409.379 738.945 416.462 743.167C436.237 754.952 460.018 775.433 451.443 801.497C450.944 803.013 446.17 805.964 444.242 804.556C444.861 801.7 446.802 797.753 448.045 794.966C449.098 792.267 449.668 789.82 450.391 787.029C442.345 764.756 406.526 741.398 382.751 740.083C378.448 739.845 372.743 741.004 368.543 741.952C375.045 735.189 377.488 734.52 386.543 733.189Z"/><path fill="white" d="M933.582 255.274C942.34 265.425 947.396 284.147 950.92 296.914C949.36 298.72 943.152 306.636 941.613 306.8C935.518 290.397 932.689 284.512 923.048 269.82C927.677 264.685 929.841 261.09 933.582 255.274Z"/><path fill="white" d="M329.481 830.532C333.189 830.374 346.533 831.211 344.603 837.169C343.102 838.689 342.604 838.708 340.51 839.448C335.512 840.375 328.676 840.293 325.055 836.168C324.22 832.795 326.727 831.824 329.481 830.532Z"/><path fill="var(--palette-cool-steel)" d="M963.188 231.906L963.518 232.244C965.262 238.627 956.871 258.281 951.845 260.959L951.05 260.206L948.359 256.12C956.762 246.945 959.309 243.648 963.188 231.906Z"/><path fill="white" d="M198.923 968.389C211.357 970.485 201.128 979.12 194.723 981.593C192.566 981.655 191.379 981.925 190.071 980.084C190.278 977.153 196.548 971.199 198.923 968.389Z"/><path fill="var(--palette-carbon-black)" d="M683.301 40.1517C689.312 39.3746 692.223 40.462 694.958 46.1325C698.187 52.8283 706.043 70.31 705.487 77.1719C705.095 81.9926 694.389 100.429 691.626 105.742C694.784 122.045 698.271 139.041 700.64 155.406C702.729 169.841 704.259 185.4 705.539 199.932C721.669 202.895 738.379 213.901 727.935 233.406C723.733 241.254 712.159 245.395 703.763 247.331C700.694 272.246 689.675 300.873 675.861 321.765C657.203 349.981 629.468 370.984 595.993 377.8C565.727 383.747 534.339 377.339 508.827 360.003C472.833 335.742 448.013 298.117 439.874 255.48C434.109 257.637 423.877 263.036 418.136 266.026C408.973 270.798 397.682 276.188 388.964 281.508C402.636 305.611 409.755 326.127 411.317 354.194C414.868 408.384 396.644 461.75 360.688 502.449C312.248 556.364 225.269 571.679 164.525 529.589C164.003 529.227 163.44 529.235 162.845 529.266L162.413 530.131C159.49 542.371 157.626 551.121 150.855 561.99C143.122 574.821 129.726 579.444 116.004 582.881C95.7305 587.958 58.6997 580.763 68.9215 551.818C71.8782 543.445 76.7593 535.541 81.3027 527.74C91.1915 510.702 101.779 494.081 113.039 477.917C108.307 470.292 102.466 462.12 97.5176 454.443C93.3401 447.962 87.1069 437.722 82.491 432.092C70.5656 428.345 61.1573 434.268 50.4289 431.891C46.1561 430.945 43.7224 428.637 41.5411 424.956C37.3177 417.829 33.3907 403.344 35.7447 395.262C38.3779 386.221 112.994 325.958 124.41 317.547C142.707 304.066 161.517 290.74 181.252 279.446C192.711 272.888 204.842 267.409 216.953 262.177C252.133 246.978 291.232 236.15 329.84 241.714C336.517 242.676 342.941 244.429 349.439 246.19C361.046 239.173 363.689 231.839 373.356 223.032C395.381 202.965 417.254 191.584 447.152 192.526C450.362 182.034 458.779 168.134 465.179 158.862C510.174 93.6777 607.549 53.2857 683.301 40.1517Z"/><path fill="white" d="M300.567 249.209C349.907 243.012 386.238 279.116 397.22 324.573C418.549 412.866 370.05 519.963 276.916 541.668C236.548 551.076 204.71 544.609 169.67 523.226C141.223 503.716 126.446 483.308 107.664 454.89C102.184 446.6 95.5705 434.295 88.7734 427.439C83.3755 421.994 70.212 424.174 62.8534 424.897C57.7074 415.003 56.2345 406.168 52.2812 396.127C51.5467 394.262 47.037 393.562 45.078 393.116C50.549 388.034 57.7516 383.289 63.6019 378.446C132.02 321.802 207.818 256.417 300.567 249.209Z"/><path fill="var(--palette-carbon-black)" d="M306.618 256.217C316.714 256.329 327.572 257.171 336.937 261.182C395.159 286.12 400.679 365.406 385.907 418.08C364.037 496.067 293.128 556.226 209.286 532.138C192.344 526.387 177.859 518.188 164.818 505.85C139.883 482.362 117.373 446.056 116.594 411C114.661 323.978 231.69 259.413 306.618 256.217Z"/><path fill="var(--palette-cool-steel)" d="M362.177 292.084C367.59 298.665 372.127 308.031 374.974 316.039C401.339 390.204 360.963 494.668 284.475 521.588C255.997 531.641 224.711 530.118 197.344 517.348C185.509 511.914 173.709 502.187 164.35 493.199C178.376 454.439 198.939 410.279 218.302 373.726C221.721 367.271 243.095 357.497 250.888 353.144L324.363 312.549C337 305.661 349.605 299.153 362.177 292.084Z"/><path fill="var(--palette-carbon-black)" d="M347.562 343.721L348.694 344.493C353.538 354.031 352.202 383.222 350.483 394.264C349.423 400.739 347.879 407.125 345.864 413.369C337.027 441.235 320.464 459.046 294.661 472.338C293.238 473.154 293.826 473.019 292.275 473.164C292.894 471.944 301.496 464.448 303.251 462.722C338.289 428.267 346.594 389.988 347.562 343.721Z"/><path fill="var(--palette-carbon-black)" d="M363.029 357.88C363.589 358.247 364.419 358.798 364.608 359.44C369.252 375.162 365.727 400.685 361.881 415.28C354.52 443.219 340.75 465.587 315.913 480.123C314.552 480.866 314.57 480.907 313.073 481.229C312.184 479.81 316.806 475.996 318.118 474.662C326.056 466.543 332.924 457.442 338.554 447.58C349.332 428.725 355.634 407.41 359.233 386.031C360.724 377.172 361.172 367.199 362.926 358.377L363.029 357.88Z"/><path fill="var(--palette-cool-steel)" d="M289.844 266.176C291.109 265.942 291.054 265.98 292.335 266.203C290.268 269.656 259.665 282.387 258.361 285.756C258.903 286.044 259.574 286.401 260.374 286.826C266.057 286.086 273.536 282.096 278.676 280.569C284.512 278.834 290.359 277.504 295.92 276.147C286.839 282.056 278.029 289.299 268.716 295.297C236.432 316.017 203.089 335.04 168.823 352.289C157.329 358.276 145.787 364.751 134.302 370.567C137.147 363.243 141.253 357.492 145.842 351.235C169.294 319.253 202.268 296.921 238.502 281.63C255.243 274.565 271.712 268.906 289.844 266.176Z"/><path fill="var(--palette-cool-steel)" d="M329.749 267.891C332.415 267.789 337.893 271.366 340.312 272.777C334.933 276.371 324.164 281.405 318.089 284.682L265.512 313.024C254.583 318.915 241.082 325.908 231.816 333.997C194.8 366.312 169.647 422.465 148.463 465.738C147.923 466.953 147.69 467.823 146.652 468.637C144.701 467.888 141.942 461.557 140.177 458.73C143.559 452.215 146.966 444.998 150.762 438.512C174.248 398.381 193.92 349.835 233.155 322.189C251.071 309.566 271.095 300.049 289.951 289.471C302.325 282.529 318.156 276.539 329.151 268.343L329.749 267.891Z"/><path fill="var(--palette-cool-steel)" d="M166.978 391.445L167.405 391.852C167.17 393.158 159.45 405.657 158.253 407.759C150.31 421.794 142.822 436.081 135.801 450.599L133.008 444.851C129.085 435.214 126.921 424.942 125.791 414.626C127.83 413.134 129.792 412.087 132.051 410.967C144.04 405.022 155.453 398.232 166.978 391.445Z"/><path fill="var(--palette-cool-steel)" d="M203.161 338.986C203.339 339.11 203.516 339.234 203.694 339.358C198.066 345.139 192.561 352.038 185.243 355.728C166.519 365.167 148.268 376.978 129.699 386.452C129.278 386.45 129.555 386.492 128.978 386.021C129.537 383.049 130.642 380.791 131.809 378.008C155.711 366.134 179.226 351.006 203.161 338.986Z"/><path fill="var(--palette-carbon-black)" d="M91.2127 382.592C98.4318 382.058 109.608 383.878 104.836 393.782C100.886 401.98 89.4963 406.678 81.139 408.456C73.9657 408.844 59.5951 407.644 67.0022 396.143C71.4928 389.17 83.1479 384.265 91.2127 382.592Z"/><path fill="white" d="M92.6517 388.073C94.4525 388.019 95.1954 388.227 96.0763 389.667C95.1663 394.442 81.3182 399.718 76.7708 400.787C75.2361 400.843 74.4636 401.058 73.2428 400.169C72.1018 395.137 88.2935 388.888 92.6517 388.073Z"/><path fill="var(--palette-cool-steel)" d="M652.179 114.014C654.184 116.196 658.483 123.93 659.865 126.781C672.526 152.906 678.005 184.22 678.192 213.098C678.457 254.206 667.978 295.838 638.38 325.819C621.28 342.962 597.946 354.586 573.296 354.089C521.042 353.035 483.798 297.522 474.005 250.789C472.812 245.093 473.387 235.06 473.499 229.127C504.541 230.075 538.612 232.669 569.624 234.584C593.496 236.761 617.982 237.614 642.309 239.864C639.017 261.178 628.905 283.967 612.051 298.026C606.967 302.266 600.603 305.22 595.852 309.685C639.4 301.265 655.761 261.093 653.483 219.995C652.884 209.181 650.498 196.075 643.262 187.602C603.965 186.617 564.663 185.873 525.357 185.371C530.415 181.582 537.051 178.365 542.656 175.297L565.139 162.723L652.179 114.014Z"/><path fill="var(--palette-carbon-black)" d="M647.95 161.94C650.438 162.931 652.806 166.354 654.132 168.683C679.232 212.777 676.257 286.264 629.75 315.11C628.163 316.241 625.504 317.77 623.775 318.84C626.293 314.467 630.649 308.919 633.653 304.646C636.94 299.91 639.931 294.976 642.609 289.872C659.413 258.282 665.452 223.252 656.312 188.198C654.689 182.186 652.634 176.299 650.162 170.583C648.791 167.387 646.14 164.844 647.95 161.94Z"/><path fill="white" d="M682.896 49.6847C683.745 49.5564 684.067 49.6483 684.937 49.7089C688.112 52.4275 694.512 71.6966 696.034 76.6807C691.828 85.8799 685.987 93.6919 682.034 102.838C681.412 104.277 681.726 109.21 682.101 110.978C686.861 133.418 691.26 155.872 694.018 178.674C704.646 259.057 674.987 357.455 583.051 371.25C579.171 371.832 574.699 371.654 570.769 371.628C508.201 367.912 452.606 305.057 446.617 245.289C448.814 243.756 450.661 242.859 453.021 241.632C457.062 246.188 457.937 246.625 463.452 249.122C467.015 266.905 473.098 284.247 481.94 300.121C518.287 365.373 586.538 388.436 645.486 333.631C672.995 305.107 685.177 271.107 688.278 230.671C691.645 186.773 677.385 85.4678 619.546 82.266C586.267 80.4238 540.347 107.093 515.408 129.343C481.692 159.423 465.69 190.045 463.298 236.034C460.904 224.945 458.671 206.131 453.721 197.187C461.65 184.471 467.066 171.706 476.756 159.044C515.654 108.215 574.325 81.0636 633.889 62.3178C647.026 58.1832 669.656 51.654 682.896 49.6847Z"/><path fill="var(--palette-carbon-black)" d="M675.317 65.6482C683.336 65.5404 689.977 72.1042 686.568 80.3062C684.471 85.3495 675.366 87.8332 670.341 89.4497C651.802 92.4728 651.818 69.0583 675.317 65.6482Z"/><path fill="white" d="M671.047 73.6174C673.992 73.2975 676.311 72.7115 678.689 74.4493L678.654 75.2595C677.037 75.2303 675.882 75.1691 674.271 75.0298L673.566 75.7314C673.395 77.3051 673.796 77.7512 674.527 79.1611L674.787 79.6526C671.931 81.5894 668.968 83.0277 666.348 79.901C665.57 76.2223 668.263 75.0169 671.047 73.6174Z"/><path fill="var(--palette-cool-steel)" d="M610.328 92.6904C614.29 91.8885 623.226 92.5236 627.193 92.8816C623.034 96.3035 615.301 100.162 610.369 102.822L584.477 116.746C557.68 131.128 531.25 146.184 505.213 161.9C501.524 164.303 498.035 166.655 494.131 168.711C495.732 165.613 498.752 161.265 500.916 158.555C524.914 128.502 571.87 97.3846 610.328 92.6904Z"/><path fill="var(--palette-cool-steel)" d="M118.757 486.123C121.053 488.075 123.64 491.139 125.708 493.445C119.953 506.827 108.697 519.732 102.834 533.072C97.7769 544.577 92.0084 553.489 107.337 558.623C120.733 563.11 130.194 562.502 142.98 556.848C138.061 563.426 136.467 565.183 129.186 568.994C115.38 575.503 69.073 581.626 79.8703 552.708C82.101 546.733 87.3581 537.786 90.7011 532.052C99.4541 517.039 108.573 500.22 118.757 486.123Z"/><path fill="var(--palette-cool-steel)" d="M511.966 191.141C532.13 190.056 559.462 191.73 580.373 191.944C599.328 192.138 620.385 191.534 639.002 192.203C640.778 195.743 641.33 197.684 642.495 201.509L615.375 201.567L535.321 202.294C520.59 202.389 500.1 201.694 486.005 202.88C494.287 198.853 503.034 192.522 511.966 191.141Z"/><path fill="white" d="M632.364 95.9446C633.52 95.9663 634.123 96.3022 635.248 96.6871L635.582 97.6421C634.63 98.9904 633.281 99.7119 631.863 100.508C584.097 127.316 535.765 153.14 488.68 181.14C487.858 181.595 487.433 181.782 486.58 182.161L486.394 181.619C488.885 177.57 489.405 176.024 493.473 173.251C498.575 169.774 504.126 166.945 509.501 163.905L539.411 146.935L603.439 111.459C612.639 106.475 623.008 100.321 632.364 95.9446Z"/><path fill="white" d="M438.44 200.207C441.435 199.976 444.929 199.142 446.465 201.955C446.361 204.122 444.91 205.943 443.727 207.885C437.343 208.452 431.921 208.895 425.644 210.455C404.821 215.63 386.235 231.129 372.565 247.115C371.039 248.463 371.484 248.508 369.879 248.601C368.072 247.585 367.124 245.342 366.05 243.465C366.834 242.332 367.665 241.232 368.54 240.167C384.602 220.743 413.105 202.578 438.44 200.207Z"/><path fill="white" d="M435.747 216.632C435.969 216.607 436.725 216.767 436.984 216.812C437.693 218.226 437.502 221.208 437.516 222.937C427.382 227.904 417.318 233.013 407.326 238.262C398.987 242.66 389.381 248.136 380.641 251.272C380.28 251.365 379.859 251.252 379.437 251.198C379.904 249.293 385.69 244.363 387.348 242.698C400.602 229.382 417.18 219.988 435.747 216.632Z"/><path fill="white" d="M46.4873 399.933C48.0231 399.976 49.0146 400.337 49.5126 401.973C51.7691 409.388 53.9948 416.793 56.3417 424.192C55.4247 424.854 54.0268 424.679 52.6533 424.765C46.6018 421.883 40.8373 408.628 42.1246 402.36C43.0409 401.083 44.943 400.557 46.4873 399.933Z"/><path fill="white" d="M371.909 260.22C374.48 261.284 382.463 272.517 383.256 275.459L382.639 276.325C380.188 274.099 373.317 265.814 370.749 262.846C370.594 261.369 370.7 261.787 371.909 260.22Z"/><path fill="white" d="M359.483 248.768C361.06 249.643 363.041 253.904 363.74 255.612L363.177 255.934C361.031 254.277 357.72 253.25 357.672 250.521L359.483 248.768Z"/><path fill="var(--palette-cool-steel)" d="M444.312 217.295C446.796 218.746 449.311 225.312 449.346 228.107C447.815 225.779 444.354 220.926 443.553 218.531L444.312 217.295Z"/><path fill="white" d="M449.71 206.814C451.8 208.766 452.366 211.538 452.459 214.272L451.965 214.772C450.996 213.317 449.559 211.83 448.392 210.169C448.176 208.164 448.127 208.909 449.71 206.814Z"/>
 </svg>
-"""
\ No newline at end of file
+"""
diff --git a/tests/test_main.py b/tests/test_main.py
index f2bb68c..519696e 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -8,19 +8,11 @@ from transcription import __main__ as entrypoint
 
 
 @pytest.mark.unit
-def test_main_passes_constructed_app_to_uvicorn(monkeypatch):
-    """Non-reload execution keeps the parsed settings instance in the app."""
+def test_main_uses_cli_factory_import_string(monkeypatch):
+    """Startup uses an importable factory so Uvicorn owns app creation."""
     settings = SimpleNamespace(host="127.0.0.1", port=8123, log_level="debug", reload=False)
-    application = object()
     captured = {}
-
-    def create_app(*, settings: object) -> object:
-        assert settings is expected_settings
-        return application
-
-    expected_settings = settings
     monkeypatch.setattr(entrypoint, "parse_cli_settings", lambda: settings)
-    monkeypatch.setattr(entrypoint, "create_app", create_app)
     monkeypatch.setattr(
         entrypoint.uvicorn,
         "run",
@@ -30,8 +22,8 @@ def test_main_passes_constructed_app_to_uvicorn(monkeypatch):
     entrypoint.main()
 
     assert captured == {
-        "application": application,
-        "factory": False,
+        "application": "transcription.__main__:create_cli_app",
+        "factory": True,
         "host": "127.0.0.1",
         "port": 8123,
         "log_level": "debug",
diff --git a/tests/test_ui_theme.py b/tests/test_ui_theme.py
index 5003d2f..c56d41f 100644
--- a/tests/test_ui_theme.py
+++ b/tests/test_ui_theme.py
@@ -5,7 +5,7 @@ import re
 import pytest
 from fastapi import FastAPI
 
-from transcription.ui import register_pages
+from transcription.ui.pages import register_pages
 from transcription.ui.resources import read_css