# darrnp/beproductive-chrome-extension architecture

> Architecture diagram of the GitHub repository darrnp/beproductive-chrome-extension, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darrnp/beproductive-chrome-extension
- Repository: https://github.com/darrnp/beproductive-chrome-extension

## Overview

BeProductive combines a Vue session interface, an Express API, and a Chrome extension that tracks active-tab domains. Users configure duration and productive domains, start a session, track browsing activity, end it manually or when the timer expires, then view analytics and compare results. The README also documents PDF export; its implementation is not visible in the sampled excerpts. The extension’s tracking behavior is documented, but its complete event and API wiring was not sampled, so that connection is shown as unverified.

Main entry points: [`backend/server.ts`](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts) (Session API), [`frontend/src/components/SessionAnalytics.vue`](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue) (Analytics view), [`frontend/src/Vue_router/index.js`](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/Vue_router/index.js) (Page router), [`frontend/src/components/Home.vue`](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/Home.vue) (Session setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Session interface"]
  node_app["Vue application<br/>[main.js]"]
  node_router["Page router<br/>[index.js]"]
  node_setup["Session setup<br/>[Home.vue]"]
  node_timer["Session timer"]
end

subgraph group_api["Session service"]
  node_sessionapi["Session API<br/>[server.ts]"]
  node_sessionstate[("Session records<br/>[server.ts]")]
  node_activitystate[("Activity logs<br/>[server.ts]")]
  node_sessionmodel["Session model"]
  node_activitymodel["Activity model"]
end

subgraph group_extension["Browser tracking"]
  node_extension["Chrome extension<br/>[background.js]"]
end

subgraph group_reporting["Session reporting"]
  node_analytics["Analytics view"]
  node_formatter["Duration formatter<br/>[formatFunction.js]"]
  node_pdf["PDF export"]
  node_previous["Previous comparison"]
end

node_user(("User"))
node_tabs["Chrome Tabs API"]

node_user -->|"configures session"| node_setup
node_setup -->|"starts session"| node_sessionapi
node_sessionapi -->|"stores session"| node_sessionstate
node_sessionapi -->|"initializes logs"| node_activitystate
node_sessionapi -->|"types session"| node_sessionmodel
node_sessionapi -->|"types activity"| node_activitymodel
node_user -->|"ends session"| node_timer
node_timer -->|"ends session"| node_sessionapi
node_user -->|"uses application"| node_app
node_app -->|"installs router"| node_router
node_router -->|"routes to"| node_setup
node_router -->|"routes to"| node_timer
node_router -->|"routes to"| node_analytics
node_tabs -->|"provides active tabs"| node_extension
node_extension -.->|"submits activity"| node_sessionapi
node_sessionapi -->|"appends activity"| node_activitystate
node_analytics -->|"requests analytics"| node_sessionapi
node_sessionapi -->|"reads logs"| node_activitystate
node_analytics -->|"formats durations"| node_formatter
node_analytics -->|"compares results"| node_previous
node_analytics -->|"exports report"| node_pdf

click node_app "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/main.js"
click node_router "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/Vue_router/index.js"
click node_setup "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/Home.vue"
click node_timer "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionTracking.vue"
click node_sessionapi "https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts"
click node_sessionstate "https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts"
click node_activitystate "https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts"
click node_sessionmodel "https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/models/Session_Interface.ts"
click node_activitymodel "https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/models/ActivityLog_Interface.ts"
click node_extension "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/public/background.js"
click node_analytics "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue"
click node_formatter "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/utils/formatFunction.js"
click node_pdf "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue"
click node_previous "https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_router,node_setup,node_timer,node_user toneBlue
class node_sessionapi,node_sessionstate,node_activitystate,node_sessionmodel,node_activitymodel toneAmber
class node_extension,node_tabs toneMint
class node_analytics,node_formatter,node_pdf,node_previous toneRose
```

## Components

### Session interface

- [Vue application](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/main.js): `frontend/src/main.js`
- [Page router](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/Vue_router/index.js): `frontend/src/Vue_router/index.js`
- [Session setup](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/Home.vue): `frontend/src/components/Home.vue`
- [Session timer](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionTracking.vue): `frontend/src/components/SessionTracking.vue`

### Session service

- [Session API](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts): `backend/server.ts`
- [Session records](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts): `backend/server.ts`
- [Activity logs](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/server.ts): `backend/server.ts`
- [Session model](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/models/Session_Interface.ts): `backend/models/Session_Interface.ts`
- [Activity model](https://github.com/darrnp/beproductive-chrome-extension/blob/main/backend/models/ActivityLog_Interface.ts): `backend/models/ActivityLog_Interface.ts`

### Browser tracking

- [Chrome extension](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/public/background.js): `frontend/public/background.js`

### Session reporting

- [Analytics view](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue): `frontend/src/components/SessionAnalytics.vue`
- [Duration formatter](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/utils/formatFunction.js): `frontend/src/utils/formatFunction.js`
- [PDF export](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue): `frontend/src/components/SessionAnalytics.vue`
- [Previous comparison](https://github.com/darrnp/beproductive-chrome-extension/blob/main/frontend/src/components/SessionAnalytics.vue): `frontend/src/components/SessionAnalytics.vue`

### Other components

- **User**
- **Chrome Tabs API**

## Connections

- User → Session setup: configures session (evidence: `README.md`)
- Session setup → Session API: starts session (evidence: `frontend/src/components/Home.vue`)
- Session API → Session records: stores session (evidence: `backend/server.ts`)
- Session API → Activity logs: initializes logs (evidence: `backend/server.ts`)
- Session API → Session model: types session (evidence: `backend/server.ts`)
- Session API → Activity model: types activity (evidence: `backend/server.ts`)
- User → Session timer: ends session (evidence: `frontend/src/components/SessionTracking.vue`)
- Session timer → Session API: ends session (evidence: `frontend/src/components/SessionTracking.vue`)
- User → Vue application: uses application (evidence: `README.md`)
- Vue application → Page router: installs router (evidence: `frontend/src/main.js`)
- Page router → Session setup: routes to (evidence: `frontend/src/Vue_router/index.js`)
- Page router → Session timer: routes to (evidence: `frontend/src/Vue_router/index.js`)
- Page router → Analytics view: routes to (evidence: `frontend/src/Vue_router/index.js`)
- Chrome Tabs API → Chrome extension: provides active tabs (evidence: `README.md`)
- Chrome extension → Session API: submits activity
- Session API → Activity logs: appends activity (evidence: `backend/server.ts`)
- Analytics view → Session API: requests analytics (evidence: `frontend/src/components/SessionAnalytics.vue`)
- Session API → Activity logs: reads logs (evidence: `backend/server.ts`)
- Analytics view → Duration formatter: formats durations (evidence: `frontend/src/components/SessionAnalytics.vue`)
- Analytics view → Previous comparison: compares results (evidence: `README.md`)
- Analytics view → PDF export: exports report (evidence: `README.md`)
