Skip to content

Commit 1853ddd

Browse files
committed
docs(mobile-client): update status pages documentation
- Clarify the role of status pages in the application startup flow - Add information about automatic re-checks for app status changes - Update link to routing architecture documentation
1 parent fdafef1 commit 1853ddd

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

src/content/docs/mobile-client/features/status-pages.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,16 @@ description: Learn about the critical, app-wide status pages for maintenance and
44
---
55
import { Card, CardGrid, Aside } from '@astrojs/starlight/components';
66

7-
The mobile client includes a set of full-screen status pages designed to handle critical, app-wide states. These pages are a key part of the [two-tiered routing architecture](/docs/mobile-client/architecture/routing) and are displayed *before* the main application UI and router are ever built.
7+
The mobile client includes a set of full-screen status pages designed to handle critical, app-wide states. These pages are a key part of the [application startup flow](/docs/mobile-client/architecture/routing) and are displayed *before* the main application UI and router are ever built.
88

99
This mechanism is triggered by the `RemoteConfig` object fetched from the backend upon application startup. It allows administrators to communicate important information to all users or enforce mandatory updates.
1010

1111
<Aside>
1212
The logic for displaying these pages resides in the `_AppView` widget (`lib/app/view/app.dart`), which listens to the `AppStatus` from the `AppBloc`.
1313
</Aside>
14+
<Aside type="note" title="Automatic Re-checks">
15+
The app can also enter these states after startup. An `AppStatusService` periodically re-checks the remote configuration in the background. If it detects a change (e.g., maintenance mode has been enabled), it will immediately transition the app to the appropriate status page.
16+
</Aside>
1417

1518
## The Status Pages
1619

0 commit comments

Comments
 (0)