ersatztv/docs/blazor-route-parity.md

Blazor → SPA route parity tracker

Purpose: the living route-by-route tracker for ersatztv#91 phase (b) — retiring the legacy Blazor Server UI once every route it serves has a ChicoryTV SPA equivalent and a redirect. Update this doc in the same PR that migrates, redirects, or removes any route below — this table is the single source of truth for "what's left."

Sources of truth checked when compiling this table: ErsatzTV/LegacyUiRedirects.cs (redirect map), web/src/App.tsx (SPA route table), ErsatzTV/Pages/**/*.razor (Blazor pages still present).

How to read this

• REDIRECTED: in LegacyUiRedirects.cs's Map — the Blazor route 302s to the SPA route.
• SPA-READY (not yet redirected): the SPA screen exists and covers the functionality, but the Blazor route is still reachable directly (no redirect entry yet) — adding the redirect is a small, low-risk PR once the SPA screen has been spot-checked against the Blazor page it replaces.
• BLAZOR-ONLY: no SPA equivalent yet; removing/redirecting this route is blocked on the listed issue(s).

Section 1 — REDIRECTED

(ErsatzTV/LegacyUiRedirects.cs's Map, verified current as of this doc — 13 entries, unchanged since ersatztv#91 phase (a)/PR #148):

Blazor route	SPA route
/	/app
/channels	/app/channels
/channels/add	/app/new-channel
/schedules	/app/schedules
/playouts	/app/playouts
/media/libraries	/app/libraries
/settings/ffmpeg	/app/settings/streaming
/settings/hdhr	/app/settings/system
/settings/logging	/app/settings/logging
/settings/playout	/app/settings/playout
/settings/scanner	/app/settings/scanner
/settings/ui	/app/settings/general
/settings/xmltv	/app/settings/xmltv

Note: the settings sub-routes above are already redirected, not Blazor-only as an earlier draft of this table implied — LegacyUiRedirects.cs covers all seven /settings/* pages that have SPA equivalents. There is no Blazor-only settings sub-route left except the ones with no SPA screen at all (there are none currently — every Blazor Settings/*.razor page has both an SPA screen and a redirect).

Section 2 — SPA-READY, not yet redirected

Mutation-depth verification (2026-07-09, #203 sweep): "SPA-READY" previously meant only "screen exists". A cold adversarial review (#91 gate, findings #202–#206) proved that insufficient, so every row below was re-verified capability-by-capability (Blazor page mutations vs SPA screen + REST endpoint; accepted deviations in docs/decisions.md excluded). Verdicts:

Cluster	Verdict	Gap issue
Troubleshooting (4 routes)	PARITY-OK (block-history page-size persistence + Id>=0 History gating added 2026-07-11)	#213
Blocks/Templates/Decos/Deco-templates	PARITY-OK (block-copy UI added 2026-07-09; blocks/templates list search/filter added 2026-07-11)	—
Filler presets / Trakt / FFmpeg profiles	PARITY-OK	—
Watermarks	PARITY-OK (copy via /add?from= prefill, 2026-07-09)	—
Playout creation + alternate-schedules	PARITY-OK	—
Playout kind-editors + list actions	PARITY-OK (delete/reset/erase/scheduling-context wired + templates preview calendar, 2026-07-09)	—
Multi/rerun collections, playlists, trash	PARITY-OK (trash select-all/clear added; 100/kind cap → decisions.md)	—
Collections	PARITY-OK (custom-order endpoint + reorder UI, all-10-kind add picker, 2026-07-09)	—
Channel editor	GAPS (external logo URL, bare create, pickers)	#212
Channels-numbers / Logs	PARITY-OK / minors	#213
Search	PARITY-OK (card nav, per-card/multi-select add-to, add-all, save-as-smart-collection, 2026-07-10)	—
Media browse/detail (read paths + image browser)	PARITY-OK	—
Media browse/detail (mutations, per-show scan, episode info/troubleshoot)	PARITY-OK (shared Add-to layer + scan/info/troubleshoot wired, 2026-07-10)	—
Schedules editors	disproven — moved to Section 3	#207
Media sources	disproven — moved to Section 3	#202

Bold issues + #202 are MUST-FIX gates for #91 phase (b); #212/#213 are SHOULD-FIX.

Confirmed as of this doc: the SPA screen exists (verified against web/src/App.tsx's route table and web/src/screens/) but LegacyUiRedirects.cs has no entry for the Blazor route yet. Scheduling-parity work (#144/#162, DONE 2026-07-07, PRs #170–#175/#179) built the SPA screens for blocks/templates/decos/deco-templates/playout editors, #145 (PR #182, merged to main) built the troubleshooting/YAML-validator screens, and #141 (PR #183, merged to main) built the media detail pages + image folder browser (MediaDetailScreen.tsx's MovieDetailScreen/ShowDetailScreen/ SeasonDetailScreen/ArtistDetailScreen, ImageBrowserScreen.tsx, both dispatched via App.tsx's MediaRouteScreen sub-route wrapper, same pattern as PlayoutsRouteScreen) — none of these have been added to the redirect map yet.

Blazor route	Blazor file	SPA route	Notes
/channels/{Id:int?}	ChannelEditor.razor	/app/edit-channel/{id}	allowSubPaths
/channels/numbers	ChannelNumbers.razor	/app/channels	merged into channels table
/search	Search.razor	/app/search
/system/logs	Logs.razor	/app/logs
/system/troubleshooting	Troubleshooting/Troubleshooting.razor	/app/troubleshooting
/system/troubleshooting/block-playout	Troubleshooting/BlockPlayoutTroubleshooting.razor (+BlockPlayoutHistory.razor)	/app/troubleshooting/blocks	covered by PR #182 / #145
/system/troubleshooting/sequential-schedule	Troubleshooting/YamlValidator.razor	/app/troubleshooting/yaml	covered by PR #182 / #145
/system/troubleshooting/playback	Troubleshooting/PlaybackTroubleshooting.razor	/app/troubleshooting/playback	covered by #145 — no nav entry; entry points are the Channels table Troubleshoot action (?channel={id}) the movie detail page, and per-episode Troubleshoot actions on season detail pages (?mediaItem={id}, #209) — remaining kinds (music videos, songs, …) still need a hand-built ?mediaItem={id} URL
/blocks, /blocks/{Id:int}	Blocks.razor, BlockEditor.razor	/app/blocks(/{id})	allowSubPaths; #144 S1; list search/filter (#213) added 2026-07-11
/templates, /templates/{Id:int}	Templates.razor, TemplateEditor.razor	/app/templates(/{id})	allowSubPaths; #144 S2; list search/filter (#213) added 2026-07-11
/decos, /decos/{Id:int}	Decos.razor, DecoEditor.razor	/app/decos(/{id})	allowSubPaths; #144 S3
/deco-templates, /deco-templates/{Id:int}	DecoTemplates.razor, DecoTemplateEditor.razor	/app/deco-templates(/{id})	allowSubPaths; #144 S4
/playouts/add(/{kind})	PlayoutEditor.razor variants	/app/playouts	merged into playouts screen creation flow; #144 S5
/playouts/classic/{Id}, /playouts/block/{Id}, /playouts/scripted/{Id}, /playouts/sequential/{Id}	ClassicPlayoutEditor.razor, BlockPlayoutEditor.razor, ScriptedPlayoutEditor.razor, SequentialPlayoutEditor.razor	/app/playouts	merged; #144 S5/S6
/playouts/{Id:int}/alternate-schedules	PlayoutAlternateSchedulesEditor.razor	/app/playouts/{id}/alternate-schedules	allowSubPaths (PlayoutsRouteScreen); #144 S6/#162
/playouts/{Id:int}/templates	PlayoutTemplatesEditor.razor	/app/playouts/{id}/templates	allowSubPaths (PlayoutsRouteScreen); #144 S6/#162
/media/multi-collections(/add, /{Id}/edit)	MultiCollections.razor, MultiCollectionEditor.razor	/app/multi-collections	SPA DONE (MultiCollectionsScreen; in-screen list↔editor via local state, no sub-paths); #151
/media/rerun-collections(/add, /{Id}/edit)	RerunCollections.razor, RerunCollectionEditor.razor	/app/rerun-collections	SPA DONE (RerunCollectionsScreen; in-screen list↔editor via local state, no sub-paths); #152
/media/filler/presets(/add, /{Id}/edit)	FillerPresets.razor, FillerPresetEditor.razor	/app/filler-presets	allowSubPaths
/media/collections(/add, /{Id}/edit, /{Id})	ManualCollections.razor, CollectionEditor.razor, CollectionItems.razor + SmartCollections.razor/SmartCollectionEditor.razor	/app/collections	allowSubPaths
/media/trash	Trash.razor	/app/trash
/media/playlists(/{Id})	Playlists.razor, PlaylistEditor.razor	/app/playlists	SPA DONE (#153): group tree + playlist item editor + playout preview (PlaylistsScreen)
/media/trakt/lists(/{Id})	TraktLists.razor, TraktListEditor.razor	/app/trakt-lists(/{id})	allowSubPaths
/ffmpeg(/add, /{Id})	FFmpeg.razor, FFmpegEditor.razor	/app/ffmpeg-profiles	allowSubPaths
/watermarks(/add, /{Id})	Watermarks.razor, WatermarkEditor.razor	/app/watermarks	allowSubPaths
/media/movies(/page/{n})	MovieList.razor	/app/media?kind=movies	generic browse (MediaBrowseScreen); PR #183 / #141
/media/movies/{MovieId:int}	Movie.razor	/app/media/movies/{id}	detail page (MovieDetailScreen); PR #183 / #141
/media/tv/shows(/page/{n})	TelevisionShowList.razor	/app/media?kind=shows	generic browse; PR #183 / #141
/media/tv/shows/{ShowId:int}	TelevisionSeasonList.razor	/app/media/shows/{id}	show + season list (ShowDetailScreen); PR #183 / #141
/media/tv/seasons(/page/{n})	TelevisionSeasonSearchResults.razor	/app/media?kind=seasons	seasons browsable as a top-level kind (MediaBrowseScreen; also reachable via show drill-in); #209 review fix
/media/tv/seasons/{SeasonId:int}	TelevisionEpisodeList.razor	/app/media/seasons/{id}	season + episode list (SeasonDetailScreen); PR #183 / #141
/media/tv/episodes(/page/{n})	EpisodeList.razor	/app/media/seasons/{id}	no standalone SPA episode browse; covered via season detail drill-in; PR #183 / #141
/media/music/artists(/page/{n})	ArtistList.razor	/app/media?kind=artists	generic browse; PR #183 / #141
/media/music/artists/{ArtistId:int}	Artist.razor	/app/media/artists/{id}	detail page (ArtistDetailScreen); PR #183 / #141
/media/music/videos(/page/{n})	MusicVideoList.razor	/app/media?kind=music-videos	generic browse; PR #183 / #141
/media/music/songs(/page/{n})	SongList.razor	/app/media?kind=songs	no dedicated SPA song browse beyond generic grid; PR #183 / #141
/media/other/videos(/page/{n})	OtherVideoList.razor	/app/media?kind=other-videos	generic browse; PR #183 / #141
/media/remote/streams(/page/{n})	RemoteStreamList.razor	/app/media?kind=remote-streams	generic browse; PR #183 / #141
/media/images(/page/{n})	ImageList.razor	/app/media?kind=images	generic browse; PR #183 / #141
/media/browser/images	ImageBrowser.razor	/app/media/images/browser	interactive image grid picker used by channel editors etc. (ImageBrowserScreen); PR #183 / #141

Section 3 — BLAZOR-ONLY (blocking issues)

Playlist variant management — API gap #153 RESOLVED

#151 (multi-collections), #152 (rerun collections), and #153 (playlists) are DONE — all three now have SPA editor screens (/app/multi-collections, /app/rerun-collections, /app/playlists; see Section 2). The rerun editor offers the REST-supported selection types only (Collection, MultiCollection, SmartCollection, and the media-item types TelevisionShow/TelevisionSeason/Artist/Movie/Episode/MusicVideo/OtherVideo/Song/Image/RemoteStream); Playlist is intentionally excluded, matching RerunCollectionRequestMapping.IsSupportedSelectionType.

#153: the playlist CRUD REST API (/api/playlists/* — groups, playlists, item-list replace, and draft playout preview) plus the /app/playlists SPA screen (PlaylistsScreen) now mirror Playlists.razor (group tree, add/rename/delete groups, add/delete playlists) and PlaylistEditor.razor (per-item Collection Type over the 12 playlist item types — Collection, TelevisionShow, TelevisionSeason, Artist, MultiCollection, SmartCollection, Movie, Episode, MusicVideo, OtherVideo, Song, Image; type-conditional playback order; count; Play All; Show In EPG; reorder/copy/ remove; playout preview). IsSystem groups and playlists are read-only in the SPA, matching Blazor.

#155 RESOLVED (collection-items enumeration): GET /api/collections/{id}/items (paged) now returns a manual collection's full contents across all media kinds (reusing LibraryBrowseItemResponseModel), so the SPA /app/collections items view lists real members instead of the old lossy Lucene collection:"name" search preview. The POST /api/collections/{id}/items bogus-id case already returns 422 (guarded by AddItemsToCollectionHandler.ValidateMediaItems), not 500.

Playback troubleshooting — #145 DONE

Nothing remains here. The playback troubleshooting screen (/app/troubleshooting/playback, PlaybackTroubleshootingScreen.tsx) is built and now lives in Section 2.

Media sources — #202 (found by the #91 cold review, 2026-07-09)

Blazor route	Blazor file	Blocking issue
/media/sources/{local,plex,jellyfin,emby}/...	LocalLibraries.razor, PlexMediaSources.razor, JellyfinMediaSources.razor, EmbyMediaSources.razor + editors	#202

Previously (wrongly) listed in Section 2 as "merged into libraries screen": the SPA /app/libraries screen lists sources/libraries and can trigger scans, but source add/edit, connection parameters, path replacements, and library enable/disable have no SPA UI and no write REST API (MediaSourcesController is GET-only; the "Add Source" button is a hardcoded disabled stub). A fresh install could not connect any library without Blazor.

Schedule editors — #207 (found by the #203 mutation-depth sweep, 2026-07-09)

Blazor route	Blazor file	Blocking issue
/schedules/{Id:int}, /schedules/add, /schedules/{Id:int}/items	ScheduleEditor.razor, ScheduleItemsEditor.razor	#207

Previously (wrongly) listed in Section 2 as "merged into schedules screen": the SPA schedules screen is a near read-only viewer — no schedule create/edit/delete, every per-item inspector control hard-coded disabled (~35 Blazor fields unchangeable), add-item is defaults-only. The REST endpoints exist and are unused; only item delete/reorder and the schedule switcher work.

Remaining mutation-depth gaps inside Section 2 rows

Tracked as #91 phase (b) gates without moving whole rows — SHOULD-FIX: #212 (channel editor), #213 (remaining nits: logs sort + page-size persistence, block-history page-size/gating, blocks/templates list filter — all read-only conveniences). 2026-07-11 (branch fix/213-spa-nits): block-history page-size persistence (localStorage, key ctv-block-history-page-size, same ctv- namespace as ctv-theme) + gating the History action on block.id >= 0 (BlockPlayoutTroubleshootingScreen.tsx), and client-side name/group search/filter boxes on the Blocks and Templates list screens, all landed. Still open under #213: logs sort + page-size persistence, trash paging (tracked on a separate concurrent branch, fix/213-logs-trash). CLOSED 2026-07-09: #210 (playout delete/reset/erase/scheduling-context + preview calendar) and #211 (collection custom order + all-kind add picker); the block/watermark copy, trash select-all, and Trakt-note items of #213 landed in the same PR. CLOSED 2026-07-10: #208 (search mutations: card drill-in, per-card + multi-select add-to, query-wide Add All via GET /api/search/all-items, Save As Smart Collection) and #209 (media browse/detail: shared Add-to layer web/src/media/addTo/ on tiles + all four detail pages + child grids, per-show Quick/Deep scan gated to Plex/Jellyfin/Emby, per-episode Media Info + Troubleshoot entries; POST /api/playlists/{id}/items added). Known accepted deviations (select-mode toggle, per-card target superset) recorded in docs/decisions.md.

Section 4 — Blazor home / escape hatch

Not gated on an issue — kept separate from Section 3 because it isn't blocked on anything, just the intentional exit ramp until phase (b) removes Blazor entirely.

Blazor route	File	Notes
/system/health	Index.razor	Blazor's own home page; reachable via Settings → System "Classic UI" link.

Cross-reference: docs/handoffs/chicorytv-issue-queue.md

Keep this table and that handoff doc in sync at a high level — this table is the detailed route inventory; the handoff doc tracks issue sequencing/session planning. If they disagree on an issue's status, the more recently updated one wins; fix the stale one in the same PR you notice it.