Skip to main content

System Overview

Builder Insights is a two-application system built around one shared data model.

Applications​

Mobile app​

  • Expo SDK 54 + React Native 0.81
  • optimized for rapid capture during events and customer conversations
  • offline-first for writes and local recovery when connectivity is poor

Admin app​

  • Next.js 16 + Material UI
  • used for event management, analytics, imports, reporting, and operations

Shared model​

Both apps work against the same MongoDB-backed system of record.

Core entities:

  • events
  • insights
  • advocates
  • stats and derived reporting views

Product principles​

  • capture in the field must remain fast and reliable
  • offline write resilience is a product guarantee, not a nice-to-have
  • admin workflows should help organize, analyze, and operationalize field feedback
  • shared concepts should stay consistent across mobile and admin surfaces

Documentation split​

  • Mobile App covers capture, auth, theming, and offline behavior
  • Admin App covers management, analytics, and reporting workflows
  • Shared Platform covers data model and API shape
  • Shared Platform also covers roles/permissions and end-to-end workflow context
  • Operations covers testing, screenshots, and release processes