Troubleshooting

First, try these

Most problems are solved by one of:

Reload the page. The app updates frequently; a stale tab is the single most common cause of odd behaviour.
Hard reload (⌘/Ctrl + Shift + R) if a normal reload does not help.
Check your connection. A connection indicator shows whether you are live with the server; if it is disconnected, moves and chat will not reach anyone.

The page is blank or shows "Something went wrong on our side"

That sentence means a fault on our side, not something you did. The panel offers Retry, Reload, and Report this — use Report: it sends what we need to look into it, and you can add a note. If it happens again in the same place, say so in the note. See Error Messages for what the panel and the report contain.

Check the address is the right one.
Try a private/incognito window, which rules out an extension or a stale session.
If the sign-in screen itself does not appear, the deployment is likely misconfigured — report it.

A character sheet says the rules module did not load

This usually means the module for that character's system did not finish loading.

Try: go to the app's home page first, then navigate to the character through the campaign, rather than opening the character's URL directly. That is a known startup race, and it is a bug rather than something you are doing wrong.

If the module is disabled in Settings, enable it.

My character sheet is empty or shows the wrong fields

Check the character's system matches the campaign's.
Check the module for that system is enabled.
A character created under the "custom" system has no rules-driven fields by design.

Rolls come out wrong for my system

If a 5e character is rolling something that does not look like 5e, that is a bug, not a setting. Report it with the character, the thing you clicked, and what it rolled.

The map is blank, black, or won't load

The map may be hidden from players — ask your GM.
Very large map images take time on the first load.
If the map area is black and stays black, your browser may have lost its WebGL context. Reload the page.
Check your browser is up to date and hardware acceleration is on. Purple Cat renders maps with WebGL and needs it.

Images don't appear

Wait a moment — a fresh upload is processed before it appears.
If an image was uploaded a while ago and stopped working, report it.
A very large original may be slow on a phone.

I can't move a token

Check you actually selected it: shift-click selects, plain click impersonates.
Check you have permission — you can only move tokens you own or have been granted access to.
Check it is not mounted to another token; moving a mounted group moves through the group.

My token snaps back when I move it

Something rejected the move — usually a permission. Ask your GM whether you own that token.

Delete doesn't delete my drawing

If a text editor inside the shape has focus, it takes the keystroke. Click empty space first, then press Delete.

Report it. Layering bugs like this are real bugs, not a browser quirk.

Chat messages aren't appearing

Check the connection indicator. If you are disconnected, reload. If chat is filtered to a view (dice only, combat log), switch back to all messages.

Voice input isn't working

Your browser must have microphone permission for the site.
Choose the right microphone in Settings.
Voice transcription is a browser feature, and support varies. Chrome is the safest choice today.

AI features are missing or greyed out

The deployment may have no server-side provider key. Enter your own in Settings → AI.
A specific model may be disabled in your settings.
The in-browser model needs WebGPU; older browsers and some hardware do not have it.

Everything is slow

Large maps with many tokens, lighting, and fog are demanding. Turn lighting off to test.
Close other WebGL-heavy tabs.
On a laptop, check you are not on battery-saver graphics.

I deleted something by accident

It is in the trash and recoverable for 30 days.

→ Your Data

Reporting a bug

Include:

what you were doing, and what you expected instead,
the campaign and map or character, by name,
the app version, from Help → About,
your browser and operating system,
a screenshot if there is anything to see.

The version number matters more than people expect — it tells us whether you have a fix that already shipped.

When the app shows "Something went wrong on our side", the Report this button on that panel sends all of the above for you, plus the technical details; add what you were doing in the note.