Brierly docs
v1.0.0
Get help
● Set up

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.

/admintwo-factoraudit log

01First sign-in and setup code

Windows users

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.

  1. Start the server (Installation).
  2. Find the setup code. If ADMIN_SETUP_TOKEN is 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 run docker logs <container>. If you set ADMIN_SETUP_TOKEN yourself, use that value.
  3. Open /admin and enter the code to create the owner account (email and a strong password).
  4. Turn on two-factor sign-in for the owner in the console, as the console asks.
  5. Remove ADMIN_SETUP_TOKEN from .env once 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

PageWhat you do there
OverviewHealth 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, LegalA 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: paywallPaywall 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: featuresSwitch 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 sourceWhere questions come from, and their quality filters. Read Market data source before you go live.
QuestionsThe 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.
AnnouncementA 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 updateMinimum 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.
PurchasesOptional store verification. See Purchase verification.
Opted-in installsCounts 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.
RevenueVerified 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.
NotificationsAn 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 / ImportServer status; the log of every change; invite and manage team members with roles; import and export of settings.
Beginner tip

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.

Console page Overview: health checks and numbers at a glance.
Overview · demo console
Console page Get started checklist.
Setup, Get started · demo console
Console page Brand: app name, accent colour, support URL.
Setup, Brand · demo console
Console page Legal: privacy and terms URLs.
Setup, Legal · demo console
Console page App config: paywall switch, headline, product ids, limits.
Product, App config: paywall · demo console
Console page App config: feature switches.
Product, App config: features · demo console
Console page Market data source: provider, filters, refresh.
Product, Market data source · demo console
Console page Questions: market and custom questions.
Content, Questions · demo console
Console page Announcement: one-time message.
Product, Announcement · demo console
Console page Force update: minimum version and store links.
Product, Force update · demo console
Console page Purchases: optional store verification switches and keys.
Purchases · demo console
Console page Opted-in installs: counts from people who opted in.
Monitor, Opted-in installs · demo console
Console page Revenue: realised store purchases.
Monitor, Revenue · demo console
Console page Status: server status checks.
Monitor, Status · demo console
Console page Audit log: every change is recorded.
Monitor, Audit log · demo console
Console page Team: team members and roles.
Team · demo console