Skip to content

Web app troubleshooting

If the Toado web app is misbehaving, walk this list.

Sign-in does not work

  • OAuth (Google): third-party cookies need to be allowed for app.toado.dev and accounts.google.com. If your browser or an extension blocks them, OAuth fails silently.
  • Magic link: check your spam folder. The email is from noreply@toado.dev. Some corporate filters flag magic links as phishing.
  • Pop-up blockers: the Google sign-in opens in a pop-up window. Allow pop-ups for app.toado.dev.

If sign-in still fails, contact support with your email and the time you tried.

Board feels laggy

Common causes and quick fixes:

  • Hundreds of tickets in one column: virtualization helps but very long columns can still slow the drag interaction. Archive aggressively or split tickets across more columns.
  • Background tab throttling: Chrome throttles JavaScript on background tabs. Active focus on the Toado tab restores normal behavior.
  • Hot ticket with many comments: opening a ticket with 200+ comments is slower than opening one with 5. We are working on virtualizing comment lists.

Attachment upload fails

  • File too large: per-attachment cap is 10 MB. Compress the image and retry.
  • Unsupported format: PNG, JPG, GIF, WebP supported. PDFs and other formats are rejected.
  • Network drop mid-upload: retry. If the browser shows the file as “uploaded” but the ticket does not show it, refresh the ticket.

Theme toggle does nothing

The theme toggle persists in localStorage under the key theme. If your browser blocks localStorage for app.toado.dev (some privacy settings do), the toggle reverts on reload.

Workaround: allow localStorage for app.toado.dev, or accept that the theme reverts on reload.

Page fails to render after an update

The web app is served from Vercel’s edge with cache. After a fresh deploy, the old bundle may briefly be served. Hard-refresh the page (Cmd+Shift+R) to pull the new bundle.

If the issue persists for more than a few minutes, contact support.

”Permission denied” on a ticket

The token, role, or company-membership that grants access to that ticket has changed since you last loaded the page. Refresh.

If you are sure you should have access, check Settings › Members in the company; an admin may have removed you or changed your role.

Cannot drag a ticket between columns

Common causes:

  • You are a Viewer (read-only role). Viewers cannot move tickets. See Roles & permissions.
  • The drag is being intercepted by a browser extension (some clipboard managers and translation extensions interfere with drag events). Try in incognito with extensions off to confirm.

Search returns nothing for a ticket I just made

Search is indexed asynchronously, with a small delay (usually a few seconds). Wait briefly and re-search. If after 30 seconds your new ticket is still not in search, contact support.

Where to ask

If none of the above resolves it, get in touch. A capture of the misbehaving page is the fastest possible report.