Builder Insights Documentation

Shared platform handbook

Builder Insights connects fast field capture, offline-safe sync, and admin reporting in one shared system. This site explains how the mobile experience, admin control plane, and operations workflows fit together.

Use this site to

• understand the product before changing code or testing flows
• see how mobile capture becomes searchable admin data
• find setup, QA, release, and screenshot guidance quickly

Legacy naming

The repositories and a few hosted URLs still use devrel identifiers while the Builder Insights rename is phased in.

Platform map

Choose your path

Understand the Product

Start here to learn how the mobile experience, admin control plane, shared platform, and core workflows fit together.

Mobile Experience

Review capture behavior, offline expectations, and screenshot-backed field workflows.

Admin Control Plane

See how operators manage events, review insights, and generate reporting outputs.

Operations Handbook

Find operationalization guidance, planning artifacts, release runbooks, QA flows, and stakeholder packets.

Ask the Docs

Use the AI assistant to ask natural-language questions and get routed to the most relevant docs pages.

What each repo owns

Repository	Primary responsibility	Open it when you need to
devrel-insights	Mobile field capture app	inspect capture UX, sync logic, auth, and device behavior
devrel-insights-admin	Web control plane	inspect dashboard logic, imports, event management, and reporting
devrel-insights-docs	Shared documentation site	align teams on architecture, workflows, screenshots, QA, and release process

Start here by role

Engineer

Start in `Understand the Product`, then move into the mobile, admin, or shared platform section you are changing.

QA or PM

Use the product docs first for how the system behaves, then open the Operations Handbook for validation and rollout guidance.

Leadership or stakeholders

Start with the strategic overview, then use the Operations Handbook for rollout, readiness, and program-level visibility.

First-week checklist

1. Read Architecture > System Overview.
2. Read Architecture > Implementation Deep Dive if you are changing code or touching architecture-sensitive flows.
3. Walk through Shared Platform > Workflow Walkthrough.
4. Review Mobile Screenshots and Admin Screenshots.
5. Open Operations Runbooks > Repository Setup if you need local access.
6. Use Operations Runbooks > QA Tester Guide before validating a release.

Local development

npm install
npm run start

The local site runs at http://localhost:3000.