DevPulse Compass

DevPulse Compass is a small full-stack product that turns developer delivery metrics into a short explanation and a practical next step. It focuses on one clear flow: an individual contributor can inspect their current month, understand the likely story behind the numbers, and see what to do next. A lightweight manager summary is included for a broader team view.

What it does

• Shows monthly delivery metrics for a selected developer.
• Interprets the signal behind those metrics in plain English.
• Suggests one or two concrete actions instead of just reporting numbers.
• Summarizes the same data by manager for a quick team-level read.

Tech Stack

• React 19
• Vite
• Express
• Node.js ESM modules

Getting Started

Install dependencies:

npm install

Start the app in development mode:

npm run dev

Build the client for production:

npm run build

Run the production server after building:

npm start

How It Is Organized

• The backend API lives in server/index.js.
• The normalized workbook-derived data lives in src/shared/data.js.
• The metric and narrative logic lives in src/shared/analysis.js.
• The React UI lives in src/App.jsx and src/styles.css.

Data Model

The app uses a compact monthly fact table derived from the workbook examples. Each record contains the developer, month, team, and the five metrics used in the product:

• Lead time for changes
• Cycle time
• Bug rate
• Deployment frequency
• PR throughput

The backend computes developer and manager summaries from those records, then the frontend renders the story, evidence, and next steps.

Design Notes

• The product is intentionally narrow so the reasoning stays explainable.
• The IC view is the primary experience; the manager page is intentionally lightweight.
• The UI avoids a generic dashboard layout and uses a more editorial, narrative feel.

Folder Structure

server/
src/
  shared/
test/
index.html
vite.config.js