# stiffler56/hustle_mentor_trader architecture

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

- Interactive diagram: https://gitdiagram.com/stiffler56/hustle_mentor_trader
- Repository: https://github.com/stiffler56/hustle_mentor_trader

## Overview

Hustle Dashboard is a personal trading journal and pre-trade decision-support app. Traders assess a setup, log and review trades, then use performance and behavioral insights to inform later decisions; account tracking, challenges, and data portability support that loop. The graph also includes the app’s shared state and persistence layer. Several feature pages and integrations are indexed but not excerpted, so their presence follows the README and tree; unverified internal calls are omitted.

Main entry points: [`src/app/data/TradesContext.tsx`](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/TradesContext.tsx) (Trade State), [`src/app/routes.tsx`](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/routes.tsx) (Route Map), [`src/app/App.tsx`](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/App.tsx) (App Shell), [`src/app/data/AuthContext.tsx`](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/AuthContext.tsx) (Auth State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App Entry<br/>[main.tsx]"]
  node_app["App Shell<br/>[App.tsx]"]
  node_routes["Route Map<br/>[routes.tsx]"]
  node_authpage["Sign-in<br/>[AuthPage.tsx]"]
end

subgraph group_trade["Trade Workflow"]
  node_scorer["Pre-trade Scorer<br/>[TradeScorer.tsx]"]
  node_scorelogic["Scoring Logic<br/>[scoring.ts]"]
  node_journal["Trade Journal<br/>[Journal.tsx]"]
  node_calendar["Trade Calendar<br/>[TradeCalendar.tsx]"]
end

subgraph group_insight["Insights and Practice"]
  node_analytics["Performance Analytics<br/>[Analytics.tsx]"]
  node_advanced["Advanced Analytics"]
  node_mentor["AI Mentor<br/>[AIMentor.tsx]"]
  node_patterns["Pattern Recognition"]
  node_psychology["Psychology Journal"]
  node_challenge["Challenge Mode<br/>[Challenge.tsx]"]
end

subgraph group_accounts["Accounts"]
  node_accounts["Prop Accounts<br/>[AccountsPage.tsx]"]
  node_broker["Broker Integration"]
end

subgraph group_data["State and Integrations"]
  node_authstate["Auth State<br/>[AuthContext.tsx]"]
  node_tradesstate["Trade State<br/>[TradesContext.tsx]"]
  node_accountstate["Account State"]
  node_challengestate["Challenge State"]
  node_datamanager["Data Manager<br/>[DataManager.tsx]"]
  node_github["GitHub Sync<br/>[useGitHubSync.ts]"]
  node_notion["Notion Sync<br/>[NotionSync.tsx]"]
  node_server["Edge Function API<br/>[index.tsx]"]
  node_kv[("Key-value Store<br/>[kv_store.tsx]")]
end

node_trader(("Trader"))
node_supabase[("Supabase")]

node_trader -->|"opens"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"loads routes"| node_routes
node_app -->|"provides auth"| node_authstate
node_app -->|"provides trades"| node_tradesstate
node_app -->|"provides accounts"| node_accountstate
node_app -->|"provides challenge"| node_challengestate
node_routes -->|"routes to"| node_scorer
node_routes -->|"routes to"| node_journal
node_routes -->|"routes to"| node_analytics
node_routes -->|"routes to"| node_advanced
node_routes -->|"routes to"| node_mentor
node_routes -->|"routes to"| node_patterns
node_routes -->|"routes to"| node_psychology
node_routes -->|"routes to"| node_challenge
node_routes -->|"routes to"| node_accounts
node_routes -->|"routes to"| node_broker
node_routes -->|"auth gate"| node_authpage
node_scorer -->|"scores setup"| node_scorelogic
node_scorer -.->|"records decision"| node_tradesstate
node_journal -->|"manages trades"| node_tradesstate
node_calendar -.->|"views history"| node_tradesstate
node_analytics -.->|"analyzes history"| node_tradesstate
node_advanced -.->|"analyzes history"| node_tradesstate
node_mentor -.->|"uses history"| node_tradesstate
node_psychology -.->|"records reflections"| node_tradesstate
node_challenge -.->|"tracks progress"| node_challengestate
node_challenge -.->|"tags trades"| node_tradesstate
node_accounts -->|"manages accounts"| node_accountstate
node_accountstate -->|"reads trades"| node_tradesstate
node_broker -.->|"imports trade data"| node_tradesstate
node_authstate -->|"authenticates"| node_supabase
node_authstate -->|"requests signup"| node_server
node_tradesstate -->|"reads session"| node_authstate
node_tradesstate -->|"syncs trades"| node_server
node_server -->|"uses storage"| node_kv
node_datamanager -->|"imports exports"| node_tradesstate
node_github -.->|"syncs history"| node_tradesstate
node_notion -.->|"mirrors journal"| node_tradesstate

click node_entry "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/main.tsx"
click node_app "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/App.tsx"
click node_routes "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/routes.tsx"
click node_authpage "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AuthPage.tsx"
click node_scorer "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/TradeScorer.tsx"
click node_scorelogic "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/utils/scoring.ts"
click node_journal "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Journal.tsx"
click node_calendar "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/components/TradeCalendar.tsx"
click node_analytics "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Analytics.tsx"
click node_advanced "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AdvancedAnalytics.tsx"
click node_mentor "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AIMentor.tsx"
click node_patterns "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/PatternRecognition.tsx"
click node_psychology "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/PsychologyJournal.tsx"
click node_challenge "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Challenge.tsx"
click node_accounts "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AccountsPage.tsx"
click node_broker "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/BrokerIntegration.tsx"
click node_authstate "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/AuthContext.tsx"
click node_tradesstate "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/TradesContext.tsx"
click node_accountstate "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/PropAccountsContext.tsx"
click node_challengestate "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/ChallengeContext.tsx"
click node_datamanager "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/DataManager.tsx"
click node_github "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/hooks/useGitHubSync.ts"
click node_notion "https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/NotionSync.tsx"
click node_server "https://github.com/stiffler56/hustle_mentor_trader/blob/main/supabase/functions/server/index.tsx"
click node_kv "https://github.com/stiffler56/hustle_mentor_trader/blob/main/supabase/functions/server/kv_store.tsx"

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_entry,node_app,node_routes,node_authpage toneBlue
class node_scorer,node_scorelogic,node_journal,node_calendar,node_supabase toneAmber
class node_analytics,node_advanced,node_mentor,node_patterns,node_psychology,node_challenge toneMint
class node_accounts,node_broker toneRose
class node_authstate,node_tradesstate,node_accountstate,node_challengestate,node_datamanager,node_github,node_notion,node_server,node_kv,node_trader toneIndigo
```

## Components

### Application

- [App Entry](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/main.tsx): `src/main.tsx`
- [App Shell](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Route Map](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/routes.tsx): `src/app/routes.tsx`
- [Sign-in](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AuthPage.tsx): `src/app/pages/AuthPage.tsx`

### Trade Workflow

- [Pre-trade Scorer](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/TradeScorer.tsx): `src/app/pages/TradeScorer.tsx`
- [Scoring Logic](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/utils/scoring.ts): `src/app/utils/scoring.ts`
- [Trade Journal](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Journal.tsx): `src/app/pages/Journal.tsx`
- [Trade Calendar](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/components/TradeCalendar.tsx): `src/app/components/TradeCalendar.tsx`

### Insights and Practice

- [Performance Analytics](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Analytics.tsx): `src/app/pages/Analytics.tsx`
- [Advanced Analytics](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AdvancedAnalytics.tsx): `src/app/pages/AdvancedAnalytics.tsx`
- [AI Mentor](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AIMentor.tsx): `src/app/pages/AIMentor.tsx`
- [Pattern Recognition](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/PatternRecognition.tsx): `src/app/pages/PatternRecognition.tsx`
- [Psychology Journal](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/PsychologyJournal.tsx): `src/app/pages/PsychologyJournal.tsx`
- [Challenge Mode](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/Challenge.tsx): `src/app/pages/Challenge.tsx`

### Accounts

- [Prop Accounts](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/AccountsPage.tsx): `src/app/pages/AccountsPage.tsx`
- [Broker Integration](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/BrokerIntegration.tsx): `src/app/pages/BrokerIntegration.tsx`

### State and Integrations

- [Auth State](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/AuthContext.tsx): `src/app/data/AuthContext.tsx`
- [Trade State](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/TradesContext.tsx): `src/app/data/TradesContext.tsx`
- [Account State](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/PropAccountsContext.tsx): `src/app/data/PropAccountsContext.tsx`
- [Challenge State](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/data/ChallengeContext.tsx): `src/app/data/ChallengeContext.tsx`
- [Data Manager](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/DataManager.tsx): `src/app/pages/DataManager.tsx`
- [GitHub Sync](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/hooks/useGitHubSync.ts): `src/app/hooks/useGitHubSync.ts`
- [Notion Sync](https://github.com/stiffler56/hustle_mentor_trader/blob/main/src/app/pages/NotionSync.tsx): `src/app/pages/NotionSync.tsx`
- [Edge Function API](https://github.com/stiffler56/hustle_mentor_trader/blob/main/supabase/functions/server/index.tsx): `supabase/functions/server/index.tsx`
- [Key-value Store](https://github.com/stiffler56/hustle_mentor_trader/blob/main/supabase/functions/server/kv_store.tsx): `supabase/functions/server/kv_store.tsx`

### Other components

- **Trader**
- **Supabase**

## Connections

- Trader → App Entry: opens
- App Entry → App Shell: renders (evidence: `src/main.tsx`)
- App Shell → Route Map: loads routes (evidence: `src/app/App.tsx`)
- App Shell → Auth State: provides auth (evidence: `src/app/App.tsx`)
- App Shell → Trade State: provides trades (evidence: `src/app/App.tsx`)
- App Shell → Account State: provides accounts (evidence: `src/app/App.tsx`)
- App Shell → Challenge State: provides challenge (evidence: `src/app/App.tsx`)
- Route Map → Pre-trade Scorer: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Trade Journal: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Performance Analytics: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Advanced Analytics: routes to (evidence: `src/app/routes.tsx`)
- Route Map → AI Mentor: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Pattern Recognition: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Psychology Journal: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Challenge Mode: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Prop Accounts: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Broker Integration: routes to (evidence: `src/app/routes.tsx`)
- Route Map → Sign-in: auth gate (evidence: `src/app/App.tsx`)
- Pre-trade Scorer → Scoring Logic: scores setup
- Pre-trade Scorer → Trade State: records decision
- Trade Journal → Trade State: manages trades (evidence: `src/app/pages/Journal.tsx`)
- Trade Calendar → Trade State: views history
- Performance Analytics → Trade State: analyzes history
- Advanced Analytics → Trade State: analyzes history
- AI Mentor → Trade State: uses history
- Psychology Journal → Trade State: records reflections
- Challenge Mode → Challenge State: tracks progress
- Challenge Mode → Trade State: tags trades
- Prop Accounts → Account State: manages accounts (evidence: `src/app/pages/AccountsPage.tsx`)
- Account State → Trade State: reads trades (evidence: `src/app/data/PropAccountsContext.tsx`)
- Broker Integration → Trade State: imports trade data
- Auth State → Supabase: authenticates (evidence: `src/app/data/AuthContext.tsx`)
- Auth State → Edge Function API: requests signup (evidence: `src/app/data/AuthContext.tsx`)
- Trade State → Auth State: reads session (evidence: `src/app/data/TradesContext.tsx`)
- Trade State → Edge Function API: syncs trades (evidence: `src/app/data/TradesContext.tsx`)
- Edge Function API → Key-value Store: uses storage (evidence: `supabase/functions/server/index.tsx`)
- Data Manager → Trade State: imports exports (evidence: `src/app/pages/DataManager.tsx`)
- GitHub Sync → Trade State: syncs history
- Notion Sync → Trade State: mirrors journal
