# gitnonta/investing-in-global-stocks architecture

> Architecture diagram of the GitHub repository gitnonta/investing-in-global-stocks, 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/gitnonta/investing-in-global-stocks
- Repository: https://github.com/gitnonta/investing-in-global-stocks

## Overview

Global Stock Investment App is a Streamlit learning and analysis app for international-stock investors. Users start at the home page, follow learning topics on investment basics, stock analysis, and currency risk, then reach tips and further resources. Stock analysis lets users select a symbol and view market history and summaries using Alpha Vantage or, when available, Yahoo Finance. The graph includes the shared CSS loader as an internal presentation layer. Home-page and analysis excerpts are partial, so relationships not demonstrated there are omitted.

Main entry points: [`streamlit_app.py`](https://github.com/gitnonta/investing-in-global-stocks/blob/main/streamlit_app.py) (Home & Learning Path), [`pages/2_Stock_Data_Analysis.py`](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/2_Stock_Data_Analysis.py) (Stock Analysis), [`css_loader.py`](https://github.com/gitnonta/investing-in-global-stocks/blob/main/css_loader.py) (CSS Loader), [`pages/1_Basics_of_Investment.py`](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/1_Basics_of_Investment.py) (Investment Basics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Investment Learning"]
  node_home["Home &amp; Learning Path<br/>[streamlit_app.py]"]
  node_basics["Investment Basics"]
  node_risk["Forex &amp; Risk"]
  node_tips["Tips &amp; Resources"]
end

subgraph group_market["Stock Analysis"]
  node_analysis["Stock Analysis"]
  node_config["Market Configuration<br/>[config.py]"]
end

subgraph group_presentation["Presentation Layer"]
  node_cssloader["CSS Loader<br/>[css_loader.py]"]
  node_styles["Stylesheets"]
end

subgraph group_external["External Data"]
  node_alpha{{"Alpha Vantage"}}
  node_yahoo{{"Yahoo Finance"}}
end

node_investor(("Investor"))

node_investor -->|"opens"| node_home
node_home -->|"navigates to"| node_basics
node_home -->|"navigates to"| node_analysis
node_home -->|"navigates to"| node_risk
node_home -->|"navigates to"| node_tips
node_investor -->|"opens"| node_basics
node_investor -->|"opens"| node_analysis
node_investor -->|"opens"| node_risk
node_investor -->|"opens"| node_tips
node_analysis -->|"reads settings"| node_config
node_analysis -->|"requests prices"| node_alpha
node_analysis -->|"fetches history"| node_yahoo
node_home -->|"loads styles"| node_cssloader
node_basics -->|"loads styles"| node_cssloader
node_analysis -->|"loads styles"| node_cssloader
node_risk -->|"loads styles"| node_cssloader
node_tips -->|"loads styles"| node_cssloader
node_cssloader -->|"loads files"| node_styles

click node_home "https://github.com/gitnonta/investing-in-global-stocks/blob/main/streamlit_app.py"
click node_basics "https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/1_Basics_of_Investment.py"
click node_analysis "https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/2_Stock_Data_Analysis.py"
click node_risk "https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/3_Forex_and_Risk.py"
click node_tips "https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/4_About_and_Tips.py"
click node_config "https://github.com/gitnonta/investing-in-global-stocks/blob/main/config.py"
click node_cssloader "https://github.com/gitnonta/investing-in-global-stocks/blob/main/css_loader.py"
click node_styles "https://github.com/gitnonta/investing-in-global-stocks/tree/main/styles"

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_home,node_basics,node_risk,node_tips toneBlue
class node_analysis,node_config toneAmber
class node_cssloader,node_styles toneMint
class node_alpha,node_yahoo toneRose
class node_investor toneIndigo
```

## Components

### Investment Learning

- [Home & Learning Path](https://github.com/gitnonta/investing-in-global-stocks/blob/main/streamlit_app.py): `streamlit_app.py`
- [Investment Basics](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/1_Basics_of_Investment.py): `pages/1_Basics_of_Investment.py`
- [Forex & Risk](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/3_Forex_and_Risk.py): `pages/3_Forex_and_Risk.py`
- [Tips & Resources](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/4_About_and_Tips.py): `pages/4_About_and_Tips.py`

### Stock Analysis

- [Stock Analysis](https://github.com/gitnonta/investing-in-global-stocks/blob/main/pages/2_Stock_Data_Analysis.py): `pages/2_Stock_Data_Analysis.py`
- [Market Configuration](https://github.com/gitnonta/investing-in-global-stocks/blob/main/config.py): `config.py`

### Presentation Layer

- [CSS Loader](https://github.com/gitnonta/investing-in-global-stocks/blob/main/css_loader.py): `css_loader.py`
- [Stylesheets](https://github.com/gitnonta/investing-in-global-stocks/tree/main/styles): `styles`

### External Data

- **Alpha Vantage**
- **Yahoo Finance**

### Other components

- **Investor**

## Connections

- Investor → Home & Learning Path: opens (evidence: `README.md`)
- Home & Learning Path → Investment Basics: navigates to (evidence: `README.md`)
- Home & Learning Path → Stock Analysis: navigates to (evidence: `README.md`)
- Home & Learning Path → Forex & Risk: navigates to (evidence: `README.md`)
- Home & Learning Path → Tips & Resources: navigates to (evidence: `README.md`)
- Investor → Investment Basics: opens (evidence: `pages/1_Basics_of_Investment.py`)
- Investor → Stock Analysis: opens (evidence: `pages/2_Stock_Data_Analysis.py`)
- Investor → Forex & Risk: opens (evidence: `pages/3_Forex_and_Risk.py`)
- Investor → Tips & Resources: opens (evidence: `pages/4_About_and_Tips.py`)
- Stock Analysis → Market Configuration: reads settings (evidence: `pages/2_Stock_Data_Analysis.py`)
- Stock Analysis → Alpha Vantage: requests prices (evidence: `pages/2_Stock_Data_Analysis.py`)
- Stock Analysis → Yahoo Finance: fetches history (evidence: `pages/2_Stock_Data_Analysis.py`)
- Home & Learning Path → CSS Loader: loads styles (evidence: `streamlit_app.py`)
- Investment Basics → CSS Loader: loads styles (evidence: `pages/1_Basics_of_Investment.py`)
- Stock Analysis → CSS Loader: loads styles (evidence: `pages/2_Stock_Data_Analysis.py`)
- Forex & Risk → CSS Loader: loads styles (evidence: `pages/3_Forex_and_Risk.py`)
- Tips & Resources → CSS Loader: loads styles (evidence: `pages/4_About_and_Tips.py`)
- CSS Loader → Stylesheets: loads files (evidence: `css_loader.py`)
