Mobile App (PWA)

CiteMetrix has a Progressive Web App (PWA) at app.citemetrix.com. It’s not a traditional iOS or Android app from the App Store — it’s a web app that acts like a native app once you add it to your home screen. Same code, same backend, same data; just packaged for mobile use.

The PWA is built around three things you’d actually want on a phone: a quick-glance ModelScore view, a push-notified feed of important alerts, and the Analyst so you can ask data questions without sitting at a desk. It’s not a full replacement for the web dashboard — bigger workflows like managing your fact library or reviewing 30 hallucinations are still better on a laptop — but for “what’s new today,” the PWA is what you reach for.

Installation

On iOS (iPhone/iPad):

1. Open Safari and go to app.citemetrix.com
2. Log in with the same email and password you use on the web dashboard
3. Tap the Share button (square with an up-arrow at the bottom of the screen)
4. Scroll down and tap Add to Home Screen
5. Tap Add in the top-right

The app icon appears on your home screen. Open it and you’ll get the full-screen, no-Safari-chrome experience.

On Android:

1. Open Chrome and go to app.citemetrix.com
2. Log in
3. You should see an “Install app” prompt at the bottom of the screen — tap it
4. If you don’t see the prompt, tap the three-dot menu in the top-right and choose Add to home screen or Install app

On a tablet or desktop browser:

You can install the PWA the same way on any modern browser — Chrome, Edge, Safari (macOS Sonoma+), or Firefox with a flag. The same install flow puts an app icon in your dock or app launcher. On iPad in particular this is genuinely useful — the PWA’s tablet layout is comfortable for routine review.

Logging in

The PWA uses JWT-based authentication separate from the WordPress session your web browser uses. First-time login on a device:

1. Enter the same email/password you use on citemetrix.com
2. The PWA gets a JWT token and stores it locally
3. You stay logged in across app launches until you explicitly log out, or after extended inactivity (the token has a generous expiry; you won’t be logged out daily)

If you ever change your password on the web, you’ll need to re-enter it on the PWA next launch.

Push notifications

This is the killer feature for the PWA. When something important happens — a critical hallucination is detected, a scan fails, your ModelScore drops sharply, a competitor enters your top 3 — your phone gets a push notification.

Setting up push:

1. Open the PWA after installing it
2. The first time you visit the Alerts tab, you’ll be prompted to enable notifications
3. Tap Enable and then accept the system permission prompt

Behind the scenes, the PWA generates a Web Push subscription tied to your account and registers it with CiteMetrix’s notification service (which uses VAPID standard Web Push, not Apple Push Notification or Firebase). When an alert fires, the server sends a push directly to your device.

What triggers a push:

• Critical-severity hallucination detected — the most-impactful hallucinations push immediately so you can address them before they age
• Scan failed three times in a row — usually means an API key issue you should check
• ModelScore dropped 10+ points week-over-week — a sharp drop usually has a discoverable cause
• Manual scan completed — only fires if you explicitly triggered the scan and asked for a completion notification

What doesn’t trigger a push:

• Routine scan completions (would be too noisy)
• Minor or Moderate hallucinations (they appear in the feed but don’t push)
• Competition share-of-voice changes (review the Share of Voice page when you want a snapshot, or the weekly digest for a summary — not a push event)
• General-info updates (saved for the weekly email digest)

You can adjust which categories push in Settings → Notifications within the PWA.

The alert feed

Every alert generated for your account — including ones that didn’t push — lives in the Alerts tab. Open it to see:

• Recent critical and warning alerts (yellow or red severity badges)
• Info-level alerts (blue badges) — these don’t push but are useful to scan periodically
• Success alerts (green badges) — confirmations that something improved

Each alert links to the relevant detail view: a hallucination opens the hallucination panel, a scan failure opens scan history, a score-drop alert opens the ModelScore breakdown. Most alerts can be dismissed or marked-read; they stay in history for 30 days.

The Analyst on mobile

The PWA’s most-used tab is usually the Analyst. Mobile is where natural-language Q&A genuinely beats clicking through dashboards — you don’t have screen real estate to keep five panels open.

A few mobile-specific touches:

• Voice input — tap the microphone icon in the input bar to speak your question. The transcribed text appears in the input; review and tap send. Voice never auto-submits. Available on tablets and phones with viewport ≥ 768px.
• Persistent threads — your conversation history is preserved across sessions and across devices. Start a thread on the iPad, continue on the phone, finish on the laptop.

What the PWA doesn’t do

• It doesn’t work offline. It needs a network connection to fetch data and call the Analyst. Future offline mode could cache recent dashboard data, but isn’t built today.
• It doesn’t have full management UIs. Adding a new domain, configuring API keys, managing your team, and editing brand facts are all done on the web dashboard. The PWA is read-and-respond, not configure.
• It doesn’t replace the web dashboard. Ten minutes a day in the PWA is plenty for staying on top of what’s happening; deeper investigation work still wants a real screen.

Reinstalling and re-enabling notifications

If you uninstall and reinstall the PWA — say, you got a new phone, or you cleared site data — the push subscription is gone. You’ll need to re-enable notifications on first launch in the new install. The web app will detect the missing subscription and prompt you, but the prompt currently lives below the fold on the Alerts tab. If you don’t see push notifications after reinstalling, scroll the Alerts tab and look for the re-enable banner.

Troubleshooting

Push notifications aren’t arriving. – Check the PWA’s Settings → Notifications to confirm they’re enabled at the app level. – Check your phone’s system Settings → Notifications → CiteMetrix to confirm they’re enabled at the OS level. – Send a test notification from PWA Settings → Notifications → Test (this confirms the subscription is alive end-to-end). – If tests work but real alerts don’t arrive, the alert categories you care about may be disabled in your notification preferences.

Stuck on the login screen / auth loop. – Clear the PWA’s cached data (system Settings → Apps → CiteMetrix → Storage → Clear) – Log in again

App seems out of date. – The PWA updates automatically the next time it has network. To force an update, close the app and reopen it.

Next steps

• Install the PWA if you haven’t yet — app.citemetrix.com from your phone’s browser
• Enable push notifications on first launch
• Try asking the Analyst a question by voice — once you experience it, the value clicks