---
title: "S34 Global · Force update"
description: "Contract, a board per state (default, loading, empty, error, offline), tokens and strings."
source: "design/hifi/S34/screen.md"
---

> Part of [Brand and design](/design/llms.txt). Every page: [llms.txt](/llms.txt).

# Hi-fi: S34 Global · Force update

> Generated by `botgumi-design index` from `../../screens.json`. Edit that file, not this page.

Stage: **hifi** · Key: `global/force-update` · Data-binding map: [bindings.md](/design/hifi/s34/bindings/index.md)

Drawn in the gallery: [Global](/design/gallery/index.html#g-global). Each board is the committed HTML in `screens/`, drawn on the example data in `docs/api/examples/`.

## Contract

- **default**: Bundle version < config.min_app_version. Blocks the app.

Flows: F1 First launch → diagnostic → paywall → first real session.

Reads and calls:

- `GET /v1/config`

Local state:

- none

## Boards

One row per state. A state without boards of its own says what shows it.

| State | Board | Example data |
|---|---|---|
| default | [zh-Hans](/design/gallery/global/force-update--default.html) · [en](/design/gallery/global/force-update--default.en.html) | config.json ([zh-Hans](/design/examples/zh-Hans/config.json) · [en](/design/examples/en/config.json)) |
| loading | [no board of its own](/design/hifi/s34/bindings/index.md#states): From [states.md](/design/states/index.md) (Global sheets): — |  |
| empty | [no board of its own](/design/hifi/s34/bindings/index.md#states): From [states.md](/design/states/index.md) (Global sheets): — |  |
| error | [no board of its own](/design/hifi/s34/bindings/index.md#states): From [states.md](/design/states/index.md) (Global sheets): — · fatal: [error--generic](/design/gallery/global/error--generic.html), [force-update--default](/design/gallery/global/force-update--default.html) |  |
| offline | [no board of its own](/design/hifi/s34/bindings/index.md#states): From [states.md](/design/states/index.md) (Global sheets): [offline--toast](/design/gallery/global/offline--toast.html) |  |

### The boards

Each state as drawn (393 × 852), one board per locale. Open a board on its own for its spec panel.

**default**

[S34 default · zh-Hans](/design/gallery/global/force-update--default.html) [S34 default · en](/design/gallery/global/force-update--default.en.html)

## Tokens used

By path in `../../system/tokens.source.json`.

| Token | Where |
|---|---|
| `color.accentPrimary` | `.btn--primary` |
| `color.accentPrimaryPressed` | `.btn--primary` |
| `color.bgCanvas` | `.device`, `.screen` |
| `color.bgInverse` | `.brand-mark` |
| `color.bgSunken` | `.btn` |
| `color.textDisabled` | `.btn` |
| `color.textOnAccent` | `.btn--primary` |
| `color.textOnInverse` | `.brand-mark` |
| `color.textPrimary` | `.device`, `.home-indicator`, `.statusbar` |
| `color.textSecondary` | `.c-secondary` |
| `radius.button` | `.btn` |
| `space.s6` | `.screen` |
| `space.safeBottom` | `.screen` |
| `space.safeTop` | `.device`, `.screen` |
| `space.sizeCtaHeight` | `.btn`, `.screen` |
| `space.sizeTabbarHeight` | `.screen` |
| `typography.subheadline` | `.t-subhead` |
| `typography.title2` | `.t-title2` |

## Strings

`app.name`, `force_update.body`, `force_update.cta`, `force_update.title`, `notif.daily.title`, `paywall.projection.score`

## Notes for the app tracks

Motion, haptics, Dynamic Type and VoiceOver: [engagement.md](/design/engagement/index.md), [tokens.md](/design/tokens/index.md) §6–7 and
[ios-handoff.md](/design/ios-handoff/index.md). Open a board with `?theme=dark&dt=1.35&binds=1` to see dark mode, the largest
tested type size and every bound element.

Tracking-plan events: no tracking plan page exists yet; ADR-001 D12 names the events.

Tokens with no group in `system/tokens.source.json` yet (they stay in [tokens.css](/design/tokens.css)): `--dt`, `--font-family-text`, `--font-weight-bold`, `--font-weight-regular`, `--motion-duration-fast`, `--motion-duration-instant`, `--motion-ease-standard`.