# doreenmolly/mindful-gate architecture

> Architecture diagram of the GitHub repository doreenmolly/mindful-gate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/doreenmolly/mindful-gate
- Repository: https://github.com/doreenmolly/mindful-gate

## Overview

Mindful Gate interrupts app and site openings with a vision-board reminder, then records whether the user continued or closed the gate. In the browser extension, the content script displays the gate and writes events to local extension storage; the background listener handles close requests, while the popup shows the event count and exports CSV. The README also documents an iPhone Shortcut photo gate. Its implementation and the planned usage-analysis notebook are not present in the supplied tree, so their internal flows are not mapped.

Main entry points: [`interrupt/browser-extension/content.js`](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/content.js) (Page Gate), [`interrupt/browser-extension/popup.js`](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/popup.js) (Export Popup), [`interrupt/browser-extension/background.js`](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/background.js) (Close Handler), [`interrupt/browser-extension/manifest.json`](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/manifest.json) (Extension Manifest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phone["Phone Reminder"]
  node_iphone_shortcut["iPhone Shortcut"]
end

subgraph group_browser["Browser Gate"]
  node_content_gate["Page Gate<br/>[content.js]"]
  node_overlay_style["Gate Styling<br/>[overlay.css]"]
  node_background_listener["Close Handler<br/>[background.js]"]
  node_extension_manifest["Extension Manifest<br/>[manifest.json]"]
end

subgraph group_events["Event Records"]
  node_extension_popup["Export Popup<br/>[popup.js]"]
  node_popup_view["Popup View<br/>[popup.html]"]
  node_local_storage[("Extension Storage")]
end

node_user(("User"))
node_tab["Browser Tab"]

node_user -->|"opens app"| node_iphone_shortcut
node_user -->|"opens site"| node_tab
node_tab -->|"shows gate"| node_content_gate
node_content_gate -->|"logs events"| node_local_storage
node_content_gate -->|"sends close"| node_background_listener
node_background_listener -->|"closes tab"| node_tab
node_extension_popup -->|"reads events"| node_local_storage
node_extension_popup -->|"exports events"| node_local_storage
node_content_gate -.->|"uses styling"| node_overlay_style
node_extension_manifest -.->|"configures script"| node_content_gate
node_extension_popup -.->|"uses view"| node_popup_view

click node_content_gate "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/content.js"
click node_overlay_style "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/overlay.css"
click node_extension_popup "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/popup.js"
click node_popup_view "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/popup.html"
click node_background_listener "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/background.js"
click node_extension_manifest "https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/manifest.json"

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_iphone_shortcut,node_user,node_tab toneBlue
class node_content_gate,node_overlay_style,node_background_listener,node_extension_manifest toneAmber
class node_extension_popup,node_popup_view,node_local_storage toneMint
```

## Components

### Phone Reminder

- **iPhone Shortcut**

### Browser Gate

- [Page Gate](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/content.js): `interrupt/browser-extension/content.js`
- [Gate Styling](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/overlay.css): `interrupt/browser-extension/overlay.css`
- [Close Handler](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/background.js): `interrupt/browser-extension/background.js`
- [Extension Manifest](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/manifest.json): `interrupt/browser-extension/manifest.json`

### Event Records

- [Export Popup](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/popup.js): `interrupt/browser-extension/popup.js`
- [Popup View](https://github.com/doreenmolly/mindful-gate/blob/main/interrupt/browser-extension/popup.html): `interrupt/browser-extension/popup.html`
- **Extension Storage**

### Other components

- **User**
- **Browser Tab**

## Connections

- User → iPhone Shortcut: opens app (evidence: `README.md`)
- User → Browser Tab: opens site
- Browser Tab → Page Gate: shows gate (evidence: `interrupt/browser-extension/content.js`)
- Page Gate → Extension Storage: logs events (evidence: `interrupt/browser-extension/content.js`)
- Page Gate → Close Handler: sends close (evidence: `interrupt/browser-extension/content.js`)
- Close Handler → Browser Tab: closes tab (evidence: `interrupt/browser-extension/background.js`)
- Export Popup → Extension Storage: reads events (evidence: `interrupt/browser-extension/popup.js`)
- Export Popup → Extension Storage: exports events (evidence: `interrupt/browser-extension/popup.js`)
- Page Gate → Gate Styling: uses styling
- Extension Manifest → Page Gate: configures script
- Export Popup → Popup View: uses view
