Insta Insight

Dashboard core

InstagramRepository.refreshDashboard() is the one entry point, called from onResume() on every wake and cold launch — there’s no background service or scheduled job, by design, since the tablet isn’t always plugged in. A refresh fetches the profile, the last 6 posts’ insights in parallel (async per item), and account-level reach, then writes the result to DashboardCache. The dashboard itself grew into a 7-page swipeable pager (auto-rotating on a timer by default, tap or swipe to move manually) as more pages got added — see the phases below.

Post insights

Tapping a post opens a richer breakdown than the dashboard tiles show: saves, shares, total interactions, and for video/reels, watch time — plus a set of newer or estimated metrics (follows, profile_visits, reels_skip_rate, profile_activity) that aren’t reliably supported across accounts.

reposts_count was tried and ruled out entirely for this app: Meta rejects it outright on the Instagram Login auth surface this app uses (confirmed against two API versions and both the insights and media-node field shapes). It most likely needs the Facebook Login product instead, which would give up the secret-free token refresh this app is built around — not worth the trade for one stat.

Follower & reach history

Follower count has no historical API on Meta’s side, so the app accumulates its own daily snapshots locally (FollowerHistoryCache). Account-level reach is different — Meta does expose a real time series for it — so that’s backfilled ~30 days in one call instead of waiting to accumulate it wake by wake.

Kiosk mode

setShowWhenLocked(true) + setTurnScreenOn(true) in onCreate, combined with Android’s Screen Pinning turned on manually per-boot, gets a double-tap wake to land directly on the dashboard with no lock-screen swipe. adb shortcuts cover both re-pinning after a reboot and pushing a fresh token via onNewIntent (needed since a pinned, already-running Activity doesn’t go through onCreate again).

Comment surfacing

CommentTrackerStore tracks which top-level comments and replies on recent posts haven’t been seen in the dashboard yet, entirely locally — it never calls a write endpoint, and doesn’t rely on Instagram’s own read/like state since neither is a reliable “have I seen this” signal. It now has its own page in the pager: comments grouped by post, replies indented under a guide line with “replying to @x” context, and a tap acknowledges one with a 4-second undo window before it’s actually cleared. An unseen-count badge sits in the bottom bar rather than only on the comments page itself, so it’s visible no matter which page happens to be showing when auto-rotation lands on it.

The tracker seeds silently on its first-ever run (everything that already exists is marked seen, so the feature starts at a real “0 unread” instead of surfacing a backlog of comments that predate it).

Audience demographics

AudienceScreen renders Meta’s reached_audience_demographics metric — age and top-country breakdowns of accounts reached by this account’s content in the current month. It’s the closest thing the Graph API exposes to “who’s watching,” but it’s a hard ceiling, not a starting point: Meta reports this only as an anonymized, account-wide monthly aggregate, with no per-post or per-person breakdown to drill into.

Background refresh exceptions

Two narrow, deliberately scoped exceptions to the wake-only design, both built the same way: a self-rescheduling chain of one-time WorkManager requests rather than PeriodicWorkRequest, whose 15-minute floor is an Android-enforced minimum with no way around it.