Repository navigation
feat: screen/action tracking, Flutter NavigatorObserver, RN navigation helper, dashboard UX - #6
Open
jeremiahseun wants to merge 3 commits into
Open
jeremiahseun wants to merge 3 commits into
jeremiahseun wants to merge 3 commits into
Conversation
…UX improvements **Mobile SDKs — all platforms** - Add `screenView(name, attrs)` and `userAction(actionType, target, attrs)` APIs to iOS (Swift), Android (Kotlin), Flutter (Dart + native bridges), and React Native (TS + native modules) so apps can record which screen was active and what the user last did — exactly the crash context requested in the phase-3 roadmap item. **Flutter SDK** - New `CircleBoxNavigatorObserver` (`NavigatorObserver` subclass) that auto-records `screen_view` events on every push/pop/replace/remove with zero per-screen code. Add it once to `MaterialApp.navigatorObservers` for full navigation history. **React Native SDK** - New `createCircleBoxNavigationListener(navigationRef)` helper that plugs directly into React Navigation's `NavigationContainer.onStateChange` for automatic tracking. - Export `NavigationContainerRefLike` type for TypeScript consumers. **Dashboard** - Project overview: wire up real crash/events/storage stats from the usage API (30-day roll-up) instead of showing `--`. Added a sparkline chart for crash trends, day-over-day delta badge, and bytes-formatted storage card. - Crash detail page: full UI overhaul — crash banner, pre-crash context strip showing last screen and last user action, severity badges with colour coding, collapsible event-type groups, timeline row highlights for crash/pre-crash/ screen-view/user-action events, structured attrs chips, and copy-to-clipboard for report IDs and fingerprints. - Root layout: global clipboard event-delegation handler for copy buttons. **Samples** - All four chaos apps (iOS, Android, Flutter, React Native) updated with "Record Screen View" and "Record User Action" demo buttons. https://claude.ai/code/session_01M2SM2GfBsPiWrFynVPvCCc
- crash-detail-page.tsx: cast unknown attrs values to String() before rendering as JSX children; use !! to convert unknown guard expressions to boolean in && short-circuits. Fixes all cloud-types TS2322 errors. - circlebox_navigator_observer.dart: wrap CircleBox.screenView() call in unawaited() and import dart:async. Fixes unawaited_futures lint in the Flutter plugin, adapters, and cloud CI jobs (all use the local circlebox_flutter path override and analyze it as workspace code). https://claude.ai/code/session_01M2SM2GfBsPiWrFynVPvCCc
tar -czf artifacts/foo.tgz . tries to archive the output file while writing it. Newer GNU tar (ubuntu-latest) returns exit code 1 when a file changes during archiving, causing all three Flutter packaging jobs (plugin, adapters, cloud) to fail after passing analyze and test. Add --exclude=./artifacts to each tar command so the output file is never included in the archive. https://claude.ai/code/session_01M2SM2GfBsPiWrFynVPvCCc
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR implements the top roadmap request ("knowing which screen, and what was pressed or happened before the crash") across all four SDK platforms, plus a round of dashboard UX improvements.
Mobile SDKs — Screen & User Action Tracking (all platforms)
Two new first-class APIs added everywhere:
screenView(name, attrs)screen_viewevent type)userAction(actionType, target, attrs)user_actionevent type)These produce distinct event types in the ring buffer (not
breadcrumb), so the crash timeline immediately shows the last active screen and the last user interaction before the crash.iOS (Swift)
Android (Kotlin)
Flutter (Dart)
React Native (TypeScript)
Flutter —
CircleBoxNavigatorObserverNew
NavigatorObserverthat auto-recordsscreen_viewevents on every route push/pop/replace/remove with zero per-screen code:Supports a custom
nameExtractorfor apps using unnamed routes.React Native —
createCircleBoxNavigationListenerHelper that plugs directly into React Navigation's
onStateChange:Dashboard — Project Overview (real stats)
--Dashboard — Crash Detail Page (full UX overhaul)
screen_view(last screen) and lastuser_action(last tap/button) at a glance — the exact information previously buried in the raw timeline<details>tagsSamples
All four chaos apps updated with "Record Screen View" and "Record User Action" demo buttons.
Test plan
CircleBox.screenView("Home")andCircleBox.userAction("tap", "Buy"), export JSON, confirmscreen_viewanduser_actionevents appear with correct attrsCircleBoxNavigatorObserverto sample, navigate between screens, confirmscreen_viewevents appear in debug snapshotcreateCircleBoxNavigationListener, navigate, confirm eventsscreen_view/user_actionevents, confirm context strip shows last screen and last actionhttps://claude.ai/code/session_01M2SM2GfBsPiWrFynVPvCCc
Generated by Claude Code