# mmmarcee/currency-converter architecture

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

- Interactive diagram: https://gitdiagram.com/mmmarcee/currency-converter
- Repository: https://github.com/mmmarcee/currency-converter

## Overview

FiatFlux is a currency-conversion frontend with an ASP.NET API for live rates, conversions, and historical-rate queries. The main user flow is browser routing to the home screen, entering currencies and an amount, calling the conversion endpoint, and displaying the returned result; the chart screens use bundled sample data. Registration and login routes exist, but the available evidence does not show a connected authentication service. The API’s history capability is represented, but no frontend-to-history call is evidenced.

Main entry points: [`frontend/src/main.jsx`](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/main.jsx) (Route entry), [`frontend/src/components/Header/Header.jsx`](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Header.jsx) (Site header), [`frontend/src/components/Converter/Converter.jsx`](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Converter/Converter.jsx) (Converter), [`backend/Services/FrankfurterService.cs`](https://github.com/mmmarcee/currency-converter/blob/main/backend/Services/FrankfurterService.cs) (Rate and history service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_router["Route entry<br/>[main.jsx]"]
  node_mainlayout["Main layout<br/>[MainLayout.jsx]"]
  node_authlayout["Auth layout<br/>[AuthLayout.jsx]"]
  node_home["Home screen<br/>[Home.jsx]"]
  node_converter["Converter<br/>[Converter.jsx]"]
  node_currencyselect["Currency selector<br/>[CurrencySelect.jsx]"]
  node_currencydata["Currency and UI data<br/>[Arrays.jsx]"]
  node_chartlist["Chart collection<br/>[ChartMain.jsx]"]
  node_chart["Rate chart<br/>[Chart.jsx]"]
  node_chartdata["Sample chart data<br/>[data.js]"]
  node_header["Site header<br/>[Header.jsx]"]
  node_headercontrols["Header controls<br/>[HeaderButtons.jsx]"]
  node_headerindex["Header index<br/>[HeaderIndex.jsx]"]
  node_headerroad["Header road<br/>[HeaderRoad.jsx]"]
  node_notifications["Notifications<br/>[Notifications.jsx]"]
  node_profile["Profile panel<br/>[Profile.jsx]"]
  node_register["Registration screen<br/>[Register.jsx]"]
  node_login["Login screen<br/>[Login.jsx]"]
end

subgraph group_api["Currency API"]
  node_controller["Currency endpoints"]
  node_service["Rate and history service"]
  node_ratecontract["Rate response model<br/>[FrankfurterRate.cs]"]
  node_currencycontract["Currency rate model<br/>[CurrencyRate.cs]"]
end

subgraph group_integration["External rates"]
  node_frankfurter{{"Frankfurter rates API"}}
end

node_visitor(("Visitor"))

node_visitor -->|"opens app"| node_router
node_router -->|"routes home"| node_mainlayout
node_router -->|"routes auth"| node_authlayout
node_router -->|"routes home"| node_home
node_router -->|"routes registration"| node_register
node_router -->|"routes login"| node_login
node_mainlayout -->|"renders"| node_header
node_home -->|"renders"| node_converter
node_home -->|"renders"| node_chartlist
node_converter -->|"renders"| node_currencyselect
node_converter -->|"reads currencies"| node_currencydata
node_converter -->|"requests conversion"| node_controller
node_chartlist -->|"renders charts"| node_chart
node_chart -->|"reads sample data"| node_chartdata
node_header -->|"renders"| node_headercontrols
node_header -->|"renders"| node_headerindex
node_header -->|"renders"| node_headerroad
node_header -->|"renders"| node_notifications
node_header -->|"renders"| node_profile
node_notifications -->|"reads notifications"| node_currencydata
node_profile -->|"reads profile data"| node_currencydata
node_controller -->|"calls"| node_service
node_service -->|"deserializes rates"| node_ratecontract
node_service -->|"returns currency rate"| node_currencycontract
node_service -->|"fetches rates"| node_frankfurter

click node_router "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/main.jsx"
click node_mainlayout "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/layouts/MainLayout.jsx"
click node_authlayout "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/layouts/AuthLayout.jsx"
click node_home "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Home/Home.jsx"
click node_converter "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Converter/Converter.jsx"
click node_currencyselect "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Converter/CurrencySelect.jsx"
click node_currencydata "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Arrays.jsx"
click node_chartlist "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/ChartMain.jsx"
click node_chart "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/Chart.jsx"
click node_chartdata "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/data.js"
click node_header "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Header.jsx"
click node_headercontrols "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderButtons.jsx"
click node_headerindex "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderIndex.jsx"
click node_headerroad "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderRoad.jsx"
click node_notifications "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Notifications.jsx"
click node_profile "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Profile.jsx"
click node_register "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Auth/Register.jsx"
click node_login "https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Auth/Login.jsx"
click node_controller "https://github.com/mmmarcee/currency-converter/blob/main/backend/Controllers/CurrencyController.cs"
click node_service "https://github.com/mmmarcee/currency-converter/blob/main/backend/Services/FrankfurterService.cs"
click node_ratecontract "https://github.com/mmmarcee/currency-converter/blob/main/backend/Models/FrankfurterRate.cs"
click node_currencycontract "https://github.com/mmmarcee/currency-converter/blob/main/backend/Models/CurrencyRate.cs"

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_router,node_mainlayout,node_authlayout,node_home,node_converter,node_currencyselect,node_currencydata,node_chartlist,node_chart,node_chartdata,node_header,node_headercontrols,node_headerindex,node_headerroad,node_notifications,node_profile,node_register,node_login toneBlue
class node_controller,node_service,node_ratecontract,node_currencycontract toneAmber
class node_frankfurter toneMint
class node_visitor toneIndigo
```

## Components

### Web application

- [Route entry](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Main layout](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/layouts/MainLayout.jsx): `frontend/src/layouts/MainLayout.jsx`
- [Auth layout](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/layouts/AuthLayout.jsx): `frontend/src/layouts/AuthLayout.jsx`
- [Home screen](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Home/Home.jsx): `frontend/src/components/Home/Home.jsx`
- [Converter](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Converter/Converter.jsx): `frontend/src/components/Converter/Converter.jsx`
- [Currency selector](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Converter/CurrencySelect.jsx): `frontend/src/components/Converter/CurrencySelect.jsx`
- [Currency and UI data](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Arrays.jsx): `frontend/src/components/Arrays.jsx`
- [Chart collection](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/ChartMain.jsx): `frontend/src/components/Chart/ChartMain.jsx`
- [Rate chart](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/Chart.jsx): `frontend/src/components/Chart/Chart.jsx`
- [Sample chart data](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Chart/data.js): `frontend/src/components/Chart/data.js`
- [Site header](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Header.jsx): `frontend/src/components/Header/Header.jsx`
- [Header controls](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderButtons.jsx): `frontend/src/components/Header/HeaderButtons.jsx`
- [Header index](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderIndex.jsx): `frontend/src/components/Header/HeaderIndex.jsx`
- [Header road](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/HeaderRoad.jsx): `frontend/src/components/Header/HeaderRoad.jsx`
- [Notifications](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Notifications.jsx): `frontend/src/components/Header/Notifications.jsx`
- [Profile panel](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Header/Profile.jsx): `frontend/src/components/Header/Profile.jsx`
- [Registration screen](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Auth/Register.jsx): `frontend/src/components/Auth/Register.jsx`
- [Login screen](https://github.com/mmmarcee/currency-converter/blob/main/frontend/src/components/Auth/Login.jsx): `frontend/src/components/Auth/Login.jsx`

### Currency API

- [Currency endpoints](https://github.com/mmmarcee/currency-converter/blob/main/backend/Controllers/CurrencyController.cs): `backend/Controllers/CurrencyController.cs`
- [Rate and history service](https://github.com/mmmarcee/currency-converter/blob/main/backend/Services/FrankfurterService.cs): `backend/Services/FrankfurterService.cs`
- [Rate response model](https://github.com/mmmarcee/currency-converter/blob/main/backend/Models/FrankfurterRate.cs): `backend/Models/FrankfurterRate.cs`
- [Currency rate model](https://github.com/mmmarcee/currency-converter/blob/main/backend/Models/CurrencyRate.cs): `backend/Models/CurrencyRate.cs`

### External rates

- **Frankfurter rates API**

### Other components

- **Visitor**

## Connections

- Visitor → Route entry: opens app
- Route entry → Main layout: routes home (evidence: `frontend/src/main.jsx`)
- Route entry → Auth layout: routes auth (evidence: `frontend/src/main.jsx`)
- Route entry → Home screen: routes home (evidence: `frontend/src/main.jsx`)
- Route entry → Registration screen: routes registration (evidence: `frontend/src/main.jsx`)
- Route entry → Login screen: routes login (evidence: `frontend/src/main.jsx`)
- Main layout → Site header: renders (evidence: `frontend/src/layouts/MainLayout.jsx`)
- Home screen → Converter: renders (evidence: `frontend/src/components/Home/Home.jsx`)
- Home screen → Chart collection: renders (evidence: `frontend/src/components/Home/Home.jsx`)
- Converter → Currency selector: renders (evidence: `frontend/src/components/Converter/Converter.jsx`)
- Converter → Currency and UI data: reads currencies (evidence: `frontend/src/components/Converter/Converter.jsx`)
- Converter → Currency endpoints: requests conversion (evidence: `frontend/src/components/Converter/Converter.jsx`)
- Chart collection → Rate chart: renders charts (evidence: `frontend/src/components/Chart/ChartMain.jsx`)
- Rate chart → Sample chart data: reads sample data (evidence: `frontend/src/components/Chart/Chart.jsx`)
- Site header → Header controls: renders (evidence: `frontend/src/components/Header/Header.jsx`)
- Site header → Header index: renders (evidence: `frontend/src/components/Header/Header.jsx`)
- Site header → Header road: renders (evidence: `frontend/src/components/Header/Header.jsx`)
- Site header → Notifications: renders (evidence: `frontend/src/components/Header/Header.jsx`)
- Site header → Profile panel: renders (evidence: `frontend/src/components/Header/Header.jsx`)
- Notifications → Currency and UI data: reads notifications (evidence: `frontend/src/components/Header/Notifications.jsx`)
- Profile panel → Currency and UI data: reads profile data (evidence: `frontend/src/components/Header/Profile.jsx`)
- Currency endpoints → Rate and history service: calls (evidence: `backend/Controllers/CurrencyController.cs`)
- Rate and history service → Rate response model: deserializes rates (evidence: `backend/Services/FrankfurterService.cs`)
- Rate and history service → Currency rate model: returns currency rate (evidence: `backend/Services/FrankfurterService.cs`)
- Rate and history service → Frankfurter rates API: fetches rates (evidence: `backend/Services/FrankfurterService.cs`)
