"AUTH_SECRET is missing or too short"
.env has no AUTH_SECRET, or it has fewer than 16 characters. Generate one (see Installation) and restart.
"Settings row missing: run npm run db:seed"
The database exists but is empty. Run npm run db:seed.
The charts show nothing for the last days
The sample logs end on the day you ran the seed. Run npm run db:reset to make fresh sample data that ends today. On a real gym this is never an issue: members log every day.
A coach cannot open a member (404)
Coaches only see their own clients. The head coach can move the member to that coach in Coach > Members (or on the client page). This is on purpose: see Pages and roles.
"This account is on the other tab"
The sign-in page has a Member / Coach switch. A coach signing in on the Member tab (or the other way round) gets this message. Switch the tab.
Forgot password says email is not set up
Email codes need MAIL_API_URL, MAIL_API_KEY and MAIL_FROM (see Environment variables). Without them the page explains the alternative: the head coach opens Coach > Members and gives the member a new password with the key button.
Progress photo upload fails with 413
The photo is larger than UPLOAD_MAX_MB (8 MB by default), or the reverse proxy limits the body size (client_max_body_size in Nginx).
The device gets 401
The key is wrong, was revoked, or belongs to a deactivated member. Create a new key in Member > Devices; the full key is shown only once.
Changes are refused with "read-only demo"
DEMO_MODE is on. See Demo mode.
Arabic text looks mirrored inside numbers
Use the <bdi> element or dir="ltr" around mixed numbers and units, as the stat tiles do (src/components/dash/ui.tsx).