Operator console
every page explained.
The console lives at /admin on your server. It changes what the app shows without a new release. Every change is written to an audit log.
01First sign-in and setup code
Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.
- Start the server (Installation).
- Find the setup code. If
ADMIN_SETUP_TOKENis empty, the server prints a one-time setup code in its log at start (verified: the log says "No owner account yet. Open /admin and create it with this one-time setup code"). Look in the terminal, or rundocker logs <container>. If you setADMIN_SETUP_TOKENyourself, use that value. - Open
/adminand enter the code to create the owner account (email and a strong password). - Turn on two-factor sign-in for the owner in the console, as the console asks.
- Remove
ADMIN_SETUP_TOKENfrom.envonce the owner exists, and restart.
Without a session nothing in the console can be read or changed. A read-only demo, https://brierly-demo.mikodes.com/admin: Email: demo@brierly.demo · Password: brierly-demo-2026 (read-only demo account).
02Console pages
| Page | What you do there |
|---|---|
| Overview | Health checks and numbers at a glance. The checks warn when the console secret key is not set in the environment, support and privacy links are missing, product ids are missing while the paywall is on, store verification is switched on but not configured, the force update has no store link, or the market source cannot be reached or has no questions. Database and Node version are checked too. |
| Get started, Brand, Legal | A setup checklist. Brand: app name (default Brierly), accent colour (default #C4572A) and support URL. Legal: privacy and terms URLs. All are sent to the app. |
| App config: paywall | Paywall on/off, headline, subline, the four product ids (lifetime and yearly, iOS and Android), the weekly call allowance without Pro (default 5, 1 to 100), the history shown without Pro (default 30 days, 1 to 3650) and "show paywall on launch after N days" (0 = never on launch). An empty id means that product is not sold. See Store products. |
| App config: features | Switch market questions, custom questions, calibration by category, CSV export, share card and the anonymous leaderboard (off by default) on or off, and edit the data attribution line (empty = automatic for the chosen source). |
| Market data source | Where questions come from, and their quality filters. Read Market data source before you go live. |
| Questions | The list of open market questions and your custom ones. Hide or feature a market question (featured ones are the weekly set and appear first), add a custom question, edit or delete it, resolve it Yes, No or Void with a reason of 3 to 300 characters that goes to the audit log, and a button to refresh market questions now. See Custom questions. |
| Announcement | A message shown once per announcement. Title, text (at most 400 characters), optional link, and a "show until" time in UTC like 2026-12-31T23:59:00Z. Editing the text makes it new, so people who dismissed the old one see it again. Empty title = no announcement. |
| Force update | Minimum version, latest version, App Store and Google Play links, and "Required". With Required on, versions below the minimum see a blocking Update screen with the store link. |
| Purchases | Optional store verification. See Purchase verification. |
| Opted-in installs | Counts from people who enabled usage counts: platform and app version split over the last 30 days, active installs over 1, 7 and 30 days, Pro share. These are only the people who opted in, so they are lower than your real total. |
| Revenue | Verified store purchases, shown as gross price (before store fees and tax). The amount shows as unknown when the store does not report it. Sandbox and test purchases are verified but not recorded. |
| Notifications | An alert webhook URL and signing secret for console alerts (a part of the Admin Kit). No screenshot is included here; check the page in your own console. |
| Status, Audit log, Team, Export / Import | Server status; the log of every change; invite and manage team members with roles; import and export of settings. |
Changes reach phones within about five minutes (the config is cached for 5 minutes). People who are offline keep the last copy they saved.
03Screenshots
Captured from the read-only demo console of the shipped server. Fields are empty because no product ids or store keys ship with the item.















