# harsh-choksi/wheel-strategy-options-screener architecture

> Architecture diagram of the GitHub repository harsh-choksi/wheel-strategy-options-screener, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harsh-choksi/wheel-strategy-options-screener
- Repository: https://github.com/harsh-choksi/wheel-strategy-options-screener

## Overview

Wheel Strategy Screener is a web dashboard with two screening workflows: cash-secured puts (CSP) and covered calls (CC). Users configure inputs in the dashboard, optionally use a local Chrome helper to read Robinhood symbols and option quotes, and receive TradingView-enriched, option-selected results for review and CSV export. The server coordinates analysis and calculations; the browser retains manual entries and settings locally. Some public-page capabilities are documented but their implementations were not sampled, so those nodes are represented at their exact page paths without speculative connections.

Main entry points: [`src/server.js`](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/server.js) (HTTP API), [`src/lib/analyze.js`](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/analyze.js) (Scan orchestration), [`src/public/app.js`](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/app.js) (Strategy dashboard), [`extension/content-robinhood.js`](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/content-robinhood.js) (Robinhood reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_dashboard["Strategy dashboard<br/>[app.js]"]
  node_command["Command center<br/>[command-center.js]"]
  node_guide["Setup guide<br/>[guide.js]"]
  node_helperhealth["Helper health<br/>[helper-health.js]"]
  node_calculator["Calculator<br/>[calculator.js]"]
  node_contact["Contact form<br/>[contact.js]"]
  node_info["Info pages"]
end

subgraph group_helper["Robinhood helper"]
  node_background["Extension background<br/>[background.js]"]
  node_appcontent["Dashboard bridge<br/>[content-app.js]"]
  node_robinhoodcontent["Robinhood reader"]
end

subgraph group_server["Server workflows"]
  node_api["HTTP API<br/>[server.js]"]
  node_settings["Runtime config<br/>[config.js]"]
  node_rate["Rate limiting<br/>[rateLimit.js]"]
  node_http["HTTP responses<br/>[httpUtils.js]"]
  node_zip["Helper ZIP<br/>[zip.js]"]
end

subgraph group_analysis["Analysis and data"]
  node_analyze["Scan orchestration<br/>[analyze.js]"]
  node_options["Option selection<br/>[options.js]"]
  node_allocation["Portfolio allocation<br/>[calculations.js]"]
  node_market["Forecast retrieval<br/>[tradingview.js]"]
  node_mock["Mock symbols<br/>[mockSymbols.js]"]
end

node_visitor(("User"))
node_robinhood(("Robinhood session"))
node_tradingview(("TradingView"))
node_resend(("Resend email"))

node_visitor -->|"opens"| node_command
node_visitor -->|"configures and scans"| node_dashboard
node_command -->|"opens strategy"| node_dashboard
node_dashboard -->|"requests helper actions"| node_appcontent
node_appcontent -.->|"coordinates scan"| node_robinhoodcontent
node_robinhoodcontent -->|"reads symbols and quotes"| node_robinhood
node_robinhoodcontent -->|"sends scan data"| node_dashboard
node_dashboard -->|"submits scan"| node_api
node_api -->|"invokes analysis"| node_analyze
node_analyze -->|"fetches forecasts"| node_market
node_market -->|"requests market data"| node_tradingview
node_analyze -->|"selects option quotes"| node_options
node_analyze -->|"allocates portfolio"| node_allocation
node_analyze -->|"loads mock symbols"| node_mock
node_api -->|"reads runtime settings"| node_settings
node_api -->|"limits requests"| node_rate
node_api -->|"sends JSON"| node_http
node_api -->|"builds helper download"| node_zip
node_visitor -->|"reads setup"| node_guide
node_visitor -->|"checks helper"| node_helperhealth
node_visitor -->|"uses calculator"| node_calculator
node_visitor -->|"sends inquiry"| node_contact
node_visitor -->|"reads product pages"| node_info
node_api -.->|"sends contact email"| node_resend

click node_dashboard "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/app.js"
click node_command "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/command-center.js"
click node_guide "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/guide.js"
click node_helperhealth "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/helper-health.js"
click node_calculator "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/calculator.js"
click node_contact "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/contact.js"
click node_info "https://github.com/harsh-choksi/wheel-strategy-options-screener/tree/master/src/public"
click node_background "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/background.js"
click node_appcontent "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/content-app.js"
click node_robinhoodcontent "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/content-robinhood.js"
click node_api "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/server.js"
click node_settings "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/config.js"
click node_analyze "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/analyze.js"
click node_options "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/options.js"
click node_allocation "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/calculations.js"
click node_market "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/tradingview.js"
click node_mock "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/mockSymbols.js"
click node_rate "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/rateLimit.js"
click node_http "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/httpUtils.js"
click node_zip "https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/zip.js"

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_dashboard,node_command,node_guide,node_helperhealth,node_calculator,node_contact,node_info,node_visitor,node_tradingview toneBlue
class node_background,node_appcontent,node_robinhoodcontent toneAmber
class node_api,node_settings,node_rate,node_http,node_zip toneMint
class node_analyze,node_options,node_allocation,node_market,node_mock toneRose
class node_robinhood,node_resend toneIndigo
```

## Components

### Web experience

- [Strategy dashboard](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/app.js): `src/public/app.js`
- [Command center](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/command-center.js): `src/public/command-center.js`
- [Setup guide](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/guide.js): `src/public/guide.js`
- [Helper health](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/helper-health.js): `src/public/helper-health.js`
- [Calculator](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/calculator.js): `src/public/calculator.js`
- [Contact form](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/public/contact.js): `src/public/contact.js`
- [Info pages](https://github.com/harsh-choksi/wheel-strategy-options-screener/tree/master/src/public): `src/public`

### Robinhood helper

- [Extension background](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/background.js): `extension/background.js`
- [Dashboard bridge](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/content-app.js): `extension/content-app.js`
- [Robinhood reader](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/extension/content-robinhood.js): `extension/content-robinhood.js`

### Server workflows

- [HTTP API](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/server.js): `src/server.js`
- [Runtime config](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/config.js): `src/config.js`
- [Rate limiting](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/rateLimit.js): `src/lib/rateLimit.js`
- [HTTP responses](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/httpUtils.js): `src/lib/httpUtils.js`
- [Helper ZIP](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/zip.js): `src/lib/zip.js`

### Analysis and data

- [Scan orchestration](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/analyze.js): `src/lib/analyze.js`
- [Option selection](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/options.js): `src/lib/options.js`
- [Portfolio allocation](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/calculations.js): `src/lib/calculations.js`
- [Forecast retrieval](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/tradingview.js): `src/lib/tradingview.js`
- [Mock symbols](https://github.com/harsh-choksi/wheel-strategy-options-screener/blob/master/src/lib/mockSymbols.js): `src/lib/mockSymbols.js`

### Other components

- **User**
- **Robinhood session**
- **TradingView**
- **Resend email**

## Connections

- User → Command center: opens (evidence: `README.md`)
- User → Strategy dashboard: configures and scans (evidence: `README.md`)
- Command center → Strategy dashboard: opens strategy (evidence: `README.md`)
- Strategy dashboard → Dashboard bridge: requests helper actions (evidence: `src/public/app.js`)
- Dashboard bridge → Robinhood reader: coordinates scan
- Robinhood reader → Robinhood session: reads symbols and quotes (evidence: `README.md`)
- Robinhood reader → Strategy dashboard: sends scan data (evidence: `README.md`)
- Strategy dashboard → HTTP API: submits scan (evidence: `README.md`)
- HTTP API → Scan orchestration: invokes analysis (evidence: `src/server.js`)
- Scan orchestration → Forecast retrieval: fetches forecasts (evidence: `src/lib/analyze.js`)
- Forecast retrieval → TradingView: requests market data (evidence: `src/lib/tradingview.js`)
- Scan orchestration → Option selection: selects option quotes (evidence: `src/lib/analyze.js`)
- Scan orchestration → Portfolio allocation: allocates portfolio (evidence: `src/lib/analyze.js`)
- Scan orchestration → Mock symbols: loads mock symbols (evidence: `src/lib/analyze.js`)
- HTTP API → Runtime config: reads runtime settings (evidence: `src/server.js`)
- HTTP API → Rate limiting: limits requests (evidence: `src/server.js`)
- HTTP API → HTTP responses: sends JSON (evidence: `src/server.js`)
- HTTP API → Helper ZIP: builds helper download (evidence: `README.md`)
- User → Setup guide: reads setup (evidence: `README.md`)
- User → Helper health: checks helper (evidence: `README.md`)
- User → Calculator: uses calculator (evidence: `README.md`)
- User → Contact form: sends inquiry (evidence: `README.md`)
- User → Info pages: reads product pages (evidence: `README.md`)
- HTTP API → Resend email: sends contact email (evidence: `src/server.js`)
