Yardmaster shows a blank window
If the window goes empty or the buttons stop responding, a reload button appears in the middle of the screen. Your sessions keep running.
Rarely, the Yardmaster window goes empty: the sidebar, chats and toolbar vanish and only the window's own minimize, maximize and close buttons remain. A reload button gets you back in seconds, without closing the app.
Get the window back#
Wait a moment. After about 1.5 seconds of an empty window, a small card appears in the middle: "The window went blank. Click to reload."
Click Reload AMC.
The window's contents are rebuilt and you are back where you were. Your sessions keep running the whole time: only the window reloads, not the app. Text you were typing in a message box is kept.
If the app recovers by itself before you click, the card disappears on its own.
The window is not blank, but buttons stopped working#
Reload the window yourself: open the ... menu in the toolbar and click Hard Reload. It clears the window's saved copy of the app's code and reloads it, which fixes most "nothing happens when I click" problems. Sessions keep running.
It keeps happening#
Quit Yardmaster and open it again. This restarts everything, not just the window. Sessions that were working come back on their own (see Sessions come back after a crash or restart).
Try Safe Mode if it starts misbehaving again straight after opening: see Use Safe Mode.
Tell the team. Each click on Reload AMC is recorded in the app's logs, so a report helps them see what happened. See Report a problem or ask for help.
"Yardmaster code updated" in your Inbox#
You only see this card if you run Yardmaster from its source code (a git checkout) rather than the installed app. When the code changes underneath the open app, it keeps running the old code and some buttons can quietly stop working.
The card offers one button:
Reload window: only the window's code changed. Sessions keep running.
Restart app: code that loads at startup changed. You confirm first; running sessions pause for the restart and resume after it.
Yardmaster never reloads or restarts by itself. A newer change replaces the card, and the card goes away if the code moves back to where it started.
Why it happens. The window loads the app's code in pieces. If a piece cannot load (for example an out-of-date piece left behind after an update), the window can end up empty. A small watcher notices an empty window straight away and shows the card sooner (after a quarter of a second) when a piece failed to load.
What the button does. It records a recovery note with how long the window was blank in the app's heartbeat log, clears the window's cache and reloads it. If that fails, it falls back to a plain reload.
There is no setting to turn it off. The check costs almost nothing and the alternative is a window you cannot use.
The button's name still says "AMC", the app's old name. It is the same app.
The code-updated card is never shown in the installed app, and waits while git is in the middle of a rebase, merge or similar. Developers can turn it off by starting Yardmaster with
AMC_DISABLE_DEV_CODE_UPDATED_NOTICE=1.