shoppingcart-status

Out-of-band service status file for the ShoppingCart app. It lives here — on GitHub Pages, off the production box — so the apps can learn about planned maintenance or an outage even when the box itself is down and can’t answer for itself.

The mobile apps read status.json; it is advisory, never authoritative. It never stops the app from calling the API (the one exception is the minAppVersion force-update gate). Only a successful API response clears a failure state, so a stale maintenance flag can never keep a healthy app looking broken.

URLs

The fallback is used when the primary fails, so the apps don’t depend on the status.gameexperts.net DNS / Pages path. (Once a custom domain is set, *.github.io redirects to it, so the github.io URL is not a valid fallback — use the raw.githubusercontent.com one above.)

status.json schema (v1)

{
  "schema": 1,
  "state": "ok",
  "updatedAt": "2026-11-15T00:00:00Z",
  "until": null,
  "message": { "en": "Scheduled maintenance, back by 3:30 AM PT", "ru": "…" },
  "minAppVersion": { "android": "1.0.0", "ios": "1.0.0" }
}
Field Type Rules
schema int Currently 1. Clients ignore unknown fields. If schema is higher than a client supports, it uses only state and minAppVersion when parseable; otherwise treats the file as unavailable.
state "ok" | "maintenance" | "outage" Any unknown value is treated as "ok".
updatedAt ISO-8601 UTC Informational.
until ISO-8601 UTC or null Expected end; rendered in the device’s local time when present.
message object keyed by language code Client picks the device language, falls back to en, then to a built-in default. Plain text, ~200 chars max.
minAppVersion object per platform (semver) If the installed version is lower → the app shows a blocking “Update required” screen with a store link. Missing/invalid → no enforcement.

A filled-in maintenance example is in status.example.maintenance.json.

Editing the status (manual, for now)

Edit status.json on main (GitHub web/app/git). Caching caveats:

States: ok (normal), maintenance (planned window — set until + message), outage (unplanned — set state:"outage", investigate, flip back to ok once /api/health is healthy).

Hosting notes