SoulSync/webui/docs/migration

WebUI Migration Docs

This folder is the home for React migration planning work inside webui.

Purpose

• Keep migration planning close to the code it describes.
• Separate WebUI migration docs from repo-level product or backend docs.
• Give each route migration a predictable place to live.

Current Docs

• page-migration-overview.md
  • high-level route inventory
  • migration waves
  • cross-route risk assessment
• stats-migration-plan.md
  • route-specific migration plan for stats
• import-migration-plan.md
  • route-specific migration plan for import
  • implementation status and follow-up cleanup notes

Naming Guidance

• Keep one high-level backlog / sequencing doc:
  • page-migration-overview.md
• Use one route-specific plan per migration task:
  • <route>-migration-plan.md

Examples:

• search-migration-plan.md
• watchlist-migration-plan.md
• library-migration-plan.md

Scope

Use this folder for:

• migration sequencing
• route-specific implementation sketches
• React ownership cutover notes
• shell handoff notes tied to WebUI page migrations

Do not use this folder for:

• generic product docs
• backend architecture notes unrelated to WebUI migration
• permanent user-facing documentation