The custom docs domain does not load
The custom docs domain does not load
Check the Mintlify deployment, exact configured domain, DNS target, and TLS provisioning. Do not release main-site redirects before the docs domain works. Use Mintlify’s current proxy/domain instructions.
An old article link breaks
An old article link breaks
Check its explicit redirect mapping and the destination navigation entry. Keep the original source article and database record while fixing the route.
Listening activity is old or empty
Listening activity is old or empty
Check Last.fm scrobbling and the response’s
stale, checkedAt, and nowPlaying fields. Distinguish no active track, missing configuration, and upstream failure. Do not present old data as live.Artwork is missing
Artwork is missing
Check the exact names and returned source. Catalogue limits, absent metadata, or provider failures can prevent a trusted match. A neutral image is better than the wrong artist.
An email did not arrive
An email did not arrive
Check confirmation state, sender verification, suppression state, provider events, and spam filtering. Welcome-delivery failure is different from failed subscription. Do not resend a broadcast to everyone as a test.
Owner login is denied
Owner login is denied
Check expiry, callback origin, current membership/role, provider availability, and server configuration. Never bypass authorization or share a session URL.
curl works but a browser request fails
curl works but a browser request fails
Inspect Origin policy and the status response. Same-origin mutations and public reads have different boundaries. Do not allow arbitrary origins.
Motion feels slow
Motion feels slow
Check mobile mode, reduced-motion settings, off-screen pausing, active click bursts, and costly SVG filters. Avoid per-petal animation loops or decorative effects that interfere with normal scrolling.