Context Switch Transition Overlay
Component Detail
Description
A brief full-screen loading overlay shown while the app invalidates all organization-scoped Riverpod providers and re-fetches the module registry, home widgets, and navigation tabs for the new tenant. Prevents partial UI renders during the provider refresh cycle and communicates progress to the user.
context-switch-transition-overlay
Sources & reasoning
The implementation notes call out a full provider invalidation and API re-fetch on every context switch. Without an overlay this produces a visible race condition between the old and new tenant's UI. A dedicated transition overlay prevents that and satisfies the WCAG focus-management requirement during the switch.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Block user interaction during the provider invalidation and bootstrap re-fetch
- Display a minimal accessible loading indicator with a descriptive semantic label
- Dismiss automatically once the new tenant bootstrap data is loaded and providers are settled
Interfaces
show(): void
hide(): void
onBootstrapComplete: Stream<void>