Help › Troubleshooting

Troubleshooting

Quick fixes for the handful of things that can go wrong: a blank window, “Not connected”, an expired session, or missing mail.

3 min read

On this page

The app window is blank

If you launched a development build directly, the window can stay blank because the dev web server isn't running. Use npm run dev:desktop from the repo root, which starts the frontend and native shell together. A released installer build doesn't have this issue.

It says “Not connected”

Open Settings → Connection and confirm the Worker API URL is set and the Session token is filled in. If the token is empty, sign in again to regenerate it. The status dot turns green once the app can reach your Worker.

“Your session expired”

Tokens don't last forever. When a session expires the app asks you to sign in again — just log back in and your token refreshes automatically.

A test email never arrived

  • Double-check the Email Routing rule points at the flaremail-api Worker.
  • Give it a minute — routing can lag right after you create a rule.
  • Confirm Email Routing is enabled and your MX records are verified in Cloudflare.