NNyquest docs

Browser, Mobile, and UI Issues

When the page itself is acting up — render bugs, slow loads, mobile quirks.

Page is blank or stuck on a loading spinner

After 5+ seconds with nothing visible:

  1. Hard-refresh (Cmd+Shift+R on macOS, Ctrl+Shift+R on Windows/Linux) — bypasses cache and pulls the latest bundle
  2. Check the browser console (F12 → Console) for red errors. Common culprits:
    • "Failed to fetch /assets/index-XXXXXX.js" — the bundle hash changed and your browser cached the old HTML; hard-refresh fixes it
    • "Refused to execute script" / CORS — see Common Error Messages
  3. Try an incognito window — rules out extension interference
  4. Try a different browser — Chrome/Firefox/Safari/Edge are all officially supported

If the issue persists in incognito, talk to a real human.

Browser extensions are interfering

Extensions that commonly cause issues:

  • Ad blockers sometimes block our analytics endpoint, causing unrelated retries
  • Password managers can fight with our sign-in flow (multiple autofill attempts)
  • Privacy extensions (Privacy Badger, uBlock Origin) may block legitimate API calls
  • AI/chat extensions (Claude, ChatGPT widgets) can occasionally inject content

Fix: disable extensions one at a time and reload. If turning all extensions off resolves it, re-enable them one at a time to find the culprit.

"Help" panel doesn't render properly

Help is tagged data-nq-panel="1" so it inherits the active chassis's styling. If colors look broken:

  • The chassis might not have set a token the help CSS expects — known cosmetic edge case in some chassis
  • Hard-refresh and re-pick the chassis from Settings

If text is unreadable in some chassis (poor contrast), talk to a real human — we'll fix the token mapping.

Drag-and-drop conversations to projects doesn't work

Causes:

  • Wrong target. Drop must land on a specific project row, not the projects header.
  • Mobile / touch device. Drag-drop isn't supported on touch in this version. Use right-click (long-press) → Move to project.
  • Browser flag disabled. Some Chrome configurations disable HTML5 drag-drop. Toggle to defaults.
  • Conversation locked. Conversations from deleted or archived projects can't be drag-dropped. Use right-click instead.

See Moving Conversations for the full rundown.

Mobile chat input is hidden behind keyboard

On iOS Safari and some Android browsers, the keyboard pushes the chat input out of view. Workarounds:

  • Tap above the keyboard area to scroll
  • Use the chassis-specific mobile drawer (Ridgeline + most others have a hamburger toggle on small screens)
  • Rotate to landscape — the input stays visible

A keyboard-aware viewport fix is on the roadmap.

Theme / dark mode looks wrong

Each chassis has its own theme. If the look is inconsistent:

  • Chassis switch left stale CSS. Hard-refresh.
  • System dark mode preference changed mid-session. Some chassis honor prefers-color-scheme; signing out and back in should re-apply.
  • Custom CSS in a browser extension is leaking in. Try incognito.

If the theme is genuinely broken on a specific chassis, talk to a real human — that's a bug to file.

Page loads slowly

The first load fetches the full bundle (~1MB compressed). Subsequent loads should be instant from cache.

If subsequent loads are also slow:

  • Check your network — ping app.nyquest.ai should be <100ms in most regions
  • Try a different DNS — sometimes ISP DNS is slow
  • Disable extensions
  • Check status.nyquest.ai (when deployed)

The platform is hosted in EU; users in Asia/Pacific see ~200-300ms higher latency.

Streaming responses freeze or stutter

SSE streams over HTTP/2. Stutters usually mean:

  • Network blip. The stream does not automatically resume or replay. Keep any partial reply and check Usage before generating again.
  • Provider throttling. Some providers throttle long replies. Pick a different model.
  • Cellular network. SSE is sensitive to packet loss. WiFi is more reliable.

If a stream sits frozen for 60+ seconds with no progress, click Stop, preserve the partial reply, and check Usage before deciding whether to retry.

Browser back button breaks the conversation

The conversation list is React Router state. Browser back/forward should work cleanly across:

  • Switching conversations (back returns to the previous one)
  • Entering/exiting projects
  • Opening/closing the help panel

If browser navigation puts the UI in a weird state:

  • Hard-refresh
  • Click the chassis logo to return to the dashboard

Specific feature works in one chassis but not another

The 10 chassis share a unified backend; if a feature works in Ridgeline but not Matrix, that's a chassis-specific bug. Examples we've seen:

  • "Agent Mode · N steps" badge only renders in Ridgeline (cosmetic; doesn't affect functionality)
  • Some chassis don't surface the chassis-specific welcome CTA

Talk to a real human — we can prioritize fixes for chassis you actually use.

Where to next