Skip to main content

Admin App Overview

The admin app is the web control plane for Builder Insights.

Stack​

  • Next.js 16
  • React 19
  • Material UI
  • MongoDB native driver

Core jobs​

  • manage events and context used by the mobile app
  • browse, triage, and enrich captured insights
  • generate executive summaries and reports
  • support imports, operations, and admin workflows

Primary product areas​

Dashboard​

  • team and executive metrics
  • charts for sentiment, priority, product areas, and event activity
  • AI-generated executive summaries
  • map and contribution views

Events​

  • list, search, and filter events
  • create and edit event records
  • manage the event context that mobile users select during capture

Insights​

  • browse captured insight records
  • filter by sentiment, priority, and type
  • review details and AI analysis
  • create or edit records through admin workflows

Import​

  • upload PMO-style CSV data
  • learn and reuse schema mappings
  • preview transforms before import
  • detect duplicates and perform upserts

Operations​

  • review database stats
  • export CSV data
  • trigger JSON backups
  • support admin-only maintenance workflows

Settings and help​

  • manage schema aliases
  • review environment-driven configuration
  • restart onboarding and help flows

Repo references​

Use the admin repo for code-adjacent truth, especially for route behavior, env setup, and operator guidance.

Good starting points:

  • README.md
  • docs/PRODUCT_OVERVIEW.md
  • docs/TESTER-GUIDE.md